Partager via


New-AzGalleryApplicationVersion

Créez ou mettez à jour une version d’application de la galerie.

Syntaxe

New-AzGalleryApplicationVersion
   -GalleryApplicationName <String>
   -GalleryName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Install <String>
   -Remove <String>
   [-DefaultConfigFileLink <String>]
   [-PackageFileLink <String>]
   [-PublishingProfileEndOfLifeDate <DateTime>]
   [-PublishingProfileExcludeFromLatest]
   [-ReplicaCount <Int32>]
   [-Tag <Hashtable>]
   [-TargetRegion <ITargetRegion[]>]
   [-Update <String>]
   [-PackageFileName <String>]
   [-ConfigFileName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Créez ou mettez à jour une version d’application de la galerie.

Exemples

Exemple 1 : Créer une version d’application de galerie.

$ctx = New-AzStorageContext -StorageAccountName $storAccName
$SASToken = New-AzStorageBlobSASToken -Context $ctx -Container $containerName -blob $blobName -Permission r
$storAcc = Get-AzStorageAccount -ResourceGroupName $rgName -Name $storAccName
$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $storAcc.Context
$SASToken = New-AzStorageBlobSASToken -Container $containerName -Blob $blobName -Permission rwd -Context $storAcc.Context
$SASUri = $blob.ICloudBlob.Uri.AbsoluteUri + $SASToken 
New-AzGalleryApplicationVersion -ResourceGroupName $rgname -Location EastUS -GalleryName $galleryName -GalleryApplicationName $galleryApplicationName -name "0.1.0" -PackageFileLink $SASUri -Install "powershell -command 'Expand-Archive -Path package.zip -DestinationPath C:\\package\'" -Remove "del C:\\package"

Création d’une version d’application de galerie. Utilisation de l’URI SAS pour l’objet blob pour PackageFileLink.

Paramètres

-AsJob

Exécuter la commande en tant que travail

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConfigFileName

facultatif. Nom à attribuer le fichier de configuration téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de configuration est nommé le nom de l’application de la galerie ajouté avec « _config ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

facultatif. DefaultConfigurationLink de l’artefact doit être un objet blob de pages de stockage lisible.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GalleryApplicationName

Nom de la définition d’application de la galerie dans laquelle la version de l’application doit être créée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GalleryName

Nom de la galerie d’applications partagées dans laquelle réside la définition de l’application.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Install

Obligatoire. Chemin d’accès et arguments pour installer l’application de la galerie. Cela est limité à 4 096 caractères.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Emplacement de la ressource

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Nom de la version de l’application de la galerie à créer. Doit suivre le modèle de nom de version sémantique : les caractères autorisés sont des chiffres et des points. Les chiffres doivent se trouver dans la plage d’un entier 32 bits. Format : <MajorVersion>.<MinorVersion>.<Rapiécer>

Type:String
Alias:GalleryApplicationVersionName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoWait

Exécuter la commande de manière asynchrone

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Obligatoire. MediaLink de l’artefact doit être un objet blob de pages de stockage lisible.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PackageFileName

facultatif. Nom à attribuer le fichier de package téléchargé sur la machine virtuelle. Cela est limité à 4 096 caractères. S’il n’est pas spécifié, le fichier de package est nommé identique au nom de l’application de la galerie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublishingProfileEndOfLifeDate

Date de fin de vie de la version de l’image de la galerie. Cette propriété peut être utilisée à des fins de désaffectation. Cette propriété est pouvant être mise à jour.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublishingProfileExcludeFromLatest

Si la valeur est true, Machines Virtuelles déployée à partir de la dernière version de la définition d’image n’utilise pas cette version d’image.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Remove

Obligatoire. Chemin d’accès et arguments pour supprimer l’application de la galerie. Cela est limité à 4 096 caractères.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReplicaCount

Nombre de réplicas de la version d’image à créer par région. Cette propriété prend effet pour une région lorsque regionalReplicaCount n’est pas spécifié. Cette propriété est pouvant être mise à jour.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Nom du groupe de ressources.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubscriptionId

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

Type:String
Position:Named
Valeur par défaut:(Get-AzContext).Subscription.Id
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Balises de ressource

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TargetRegion

Régions cibles vers lesquelles la version de l’image sera répliquée. Cette propriété est pouvant être mise à jour. Pour construire, consultez la section NOTES pour les propriétés TARGETREGION et créez une table de hachage.

Type:ITargetRegion[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Update

facultatif. Chemin d’accès et arguments pour mettre à jour l’application de galerie. Si elle n’est pas présente, l’opération de mise à jour appelle la commande remove sur la version précédente et installe la commande sur la version actuelle de l’application de la galerie. Cela est limité à 4 096 caractères.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

IGalleryApplicationVersion