Share via


New-AzGalleryApplicationVersion

建立或更新資源庫應用程式版本。

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

Description

建立或更新資源庫應用程式版本。

範例

範例 1:建立資源庫應用程式版本。

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

建立資源庫應用程式版本。 針對 PackageFileLink 使用 Blob 的 SAS URI。

參數

-AsJob

以作業身分執行命令

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigFileName

選擇性。 要指派 VM 上下載組態檔的名稱。 這限制為 4096 個字元。 如果未指定,組態檔將會命名為附加 「_config」 的資源庫應用程式名稱。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

選擇性。 成品的 defaultConfigurationLink 必須是可讀取的記憶體分頁 Blob。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GalleryApplicationName

要在其中建立應用程式版本的資源庫應用程式定義名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GalleryName

應用程式定義所在的共用應用連結庫名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Install

必要。 安裝資源庫應用程式的路徑和自變數。 這限制為 4096 個字元。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

資源位置

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

要建立的資源庫應用程式版本名稱。 必須遵循語意版本名稱模式:允許的字元為數位和句號。 數字必須介於32位整數的範圍內。 格式: <MajorVersion>。<MinorVersion>。<補丁>

Type:String
Aliases:GalleryApplicationVersionName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

以異步方式執行命令

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

必要。 成品的 mediaLink 必須是可讀取的記憶體分頁 Blob。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageFileName

選擇性。 要指派 VM 上下載套件檔案的名稱。 這限制為 4096 個字元。 如果未指定,封裝檔案的名稱會與資源庫應用程式名稱相同。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishingProfileEndOfLifeDate

資源庫映像版本的生命週期結束日期。 這個屬性可用於解除委任用途。 這個屬性是可更新的。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishingProfileExcludeFromLatest

如果設定為 true,虛擬機器 從最新版本的映像定義部署將不會使用此映像版本。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Remove

必要。 要移除資源庫應用程式的路徑和自變數。 這限制為 4096 個字元。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaCount

要為每個區域建立之映像版本的複本數目。 如果未指定 regionReplicaCount,這個屬性就會對區域生效。 這個屬性是可更新的。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

資源群組的名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

資源標籤

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetRegion

要復寫映像版本的目標區域。 這個屬性是可更新的。 若要建構,請參閱 TARGETREGION 屬性的 NOTES 區段並建立哈希表。

Type:ITargetRegion[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Update

選擇性。 更新資源庫應用程式的路徑和自變數。 如果沒有,則更新作業將會在舊版上叫用 remove 命令,並在資源庫應用程式的目前版本上安裝命令。 這限制為 4096 個字元。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸出

IGalleryApplicationVersion