New-AzGalleryApplicationVersion

  • Referenz
Modul:
Az.Compute

Erstellen oder Aktualisieren einer Kataloganwendungsversion.

Syntax

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>]

Beschreibung

Erstellen oder Aktualisieren einer Kataloganwendungsversion.

Beispiele

Beispiel 1: Erstellen einer Kataloganwendungsversion.

$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"

Erstellen einer Kataloganwendungsversion. Verwenden des SAS-URI für das Blob für PackageFileLink.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConfigFileName

Optional. Der Name zum Zuweisen der heruntergeladenen Konfigurationsdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei mit dem Namen der Kataloganwendung benannt, der mit "_config" angefügt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultConfigFileLink

Optional. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GalleryApplicationName

Der Name der Kataloganwendungsdefinition, in der die Anwendungsversion erstellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GalleryName

Der Name des Freigegebenen Anwendungskatalogs, in dem sich die Anwendungsdefinition befindet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Install

Erforderlich. Der Pfad und die Argumente zum Installieren der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Ressourcenspeicherort

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der zu erstellenden Kataloganwendungsversion. Muss dem Namensmuster der semantischen Version folgen: Die zulässigen Zeichen sind Ziffern und Punkt. Ziffern müssen innerhalb des Bereichs einer 32-Bit-Ganzzahl liegen. Format: <MajorVersion>.<MinorVersion>.<Flicken>

Typ:String
Aliase:GalleryApplicationVersionName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageFileLink

Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageFileName

Optional. Der Name zum Zuweisen der heruntergeladenen Paketdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Paketdatei mit dem Namen der Kataloganwendung benannt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublishingProfileEndOfLifeDate

Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublishingProfileExcludeFromLatest

Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Remove

Erforderlich. Der Pfad und die Argumente zum Entfernen der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReplicaCount

Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben wird. Diese Eigenschaft ist aktualisierbar.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Ressourcentags

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TargetRegion

Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für TARGETREGION-Eigenschaften und erstellen eine Hashtabelle.

Typ:ITargetRegion[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Update

Optional. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Aktualisierungsvorgang den Befehl "Entfernen" in der vorherigen Version und den Installationsbefehl in der aktuellen Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

IGalleryApplicationVersion