你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzGalleryApplicationVersion

创建或更新库应用程序版本。

语法

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

说明

创建或更新库应用程序版本。

示例

示例 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

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConfigFileName

可选。 在 VM 上分配下载的配置文件的名称。 此限制为 4096 个字符。 如果未指定,配置文件将命名为“_config”追加的库应用程序名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

可选。 项目的 defaultConfigurationLink 必须是可读的存储页 Blob。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-GalleryApplicationName

要在其中创建应用程序版本的库应用程序定义的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-GalleryName

应用程序定义所在的共享应用程序库的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Install

必需。 用于安装库应用程序的路径和参数。 此限制为 4096 个字符。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Location

资源位置

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

要创建的库应用程序版本的名称。 需要遵循语义版本名称模式:允许的字符是数字和句点。 数字必须介于 32 位整数的范围内。 格式: <MajorVersion>。<MinorVersion>。<补丁>

类型:String
别名:GalleryApplicationVersionName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

必需。 项目的 mediaLink 必须是可读的存储页 Blob。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PackageFileName

可选。 在 VM 上分配下载的包文件的名称。 此限制为 4096 个字符。 如果未指定,包文件将命名为与库应用程序名称相同的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PublishingProfileEndOfLifeDate

库映像版本的生命周期结束日期。 此属性可用于解除授权目的。 此属性可更新。

类型:DateTime
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PublishingProfileExcludeFromLatest

如果设置为 true,则从最新版本的映像定义部署虚拟机不会使用此映像版本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Remove

必需。 用于删除库应用程序的路径和参数。 此限制为 4096 个字符。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ReplicaCount

要为每个区域创建的映像版本的副本数。 如果未指定 regionReplicaCount,此属性将对区域生效。 此属性可更新。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SubscriptionId

唯一标识 azure 订阅Microsoft的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TargetRegion

要将映像版本复制到的目标区域。 此属性可更新。 若要构造,请参阅 TARGETREGION 属性的 NOTES 部分并创建哈希表。

类型:ITargetRegion[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Update

可选。 用于更新库应用程序的路径和参数。 如果不存在,更新操作将调用上一版本的 remove 命令,并在库应用程序的当前版本上安装命令。 此限制为 4096 个字符。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

IGalleryApplicationVersion