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

Update-AzureVMImage

参考

模块:: Azure

更新映像存储库中操作系统映像的标签。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

Update-AzureVMImage
      [-ImageName] <String>
      [-Label] <String>
      [[-Eula] <String>]
      [[-Description] <String>]
      [[-ImageFamily] <String>]
      [[-PublishedDate] <DateTime>]
      [[-PrivacyUri] <Uri>]
      [[-RecommendedVMSize] <String>]
      [[-DiskConfig] <VirtualMachineImageDiskConfigSet>]
      [[-Language] <String>]
      [[-IconName] <String>]
      [[-SmallIconName] <String>]
      [-DontShowInGui]
      [-Profile <AzureSMProfile>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [<CommonParameters>]

说明

Update-AzureVMImage cmdlet 更新映像存储库中操作系统映像上的标签。它返回一个图像对象，其中包含有关更新后的映像的信息。

示例

示例 1：通过更改映像标签来更新映像

PS C:\> Update-AzureVMImage -ImageName "Windows-Server-2008-SP2" -Label "DoNotUse"

此命令通过将映像标签更改为 DoNotUse 来更新名为 Windows-Server-2008-SP2 的映像。

示例 2：按标签获取所有操作系统，然后更新标签

PS C:\> Get-AzureVMImage | Where-Object {$_.Label -eq "DoNotUse" } | Update-AzureVMImage -Label "Updated"

此命令获取标记为 DoNotUse 的所有操作系统映像，并将标签更改为“已更新”。

参数

-Description

指定操作系统映像的说明。

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

-DiskConfig

指定使用 New-AzureVMImageDiskConfigSet、Set-AzureVMImageOSDiskConfig 和 Set-AzureVMImageDataDiskConfig cmdlet 创建的虚拟机映像的操作系统磁盘和数据磁盘配置。

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

-DontShowInGui

指示此 cmdlet 不显示 GUI 中的图像。

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

-Eula

指定最终用户许可协议。建议该值为 URL。

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

-IconName

指定操作系统或虚拟机映像的标准图标名称。

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

-ImageFamily

指定可用于对操作系统或虚拟机映像进行分组的值。

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

-ImageName

指定要在映像存储库中更新的映像的名称。

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

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

继续
忽略
询问
SilentlyContinue
停止
Suspend

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

-InformationVariable

指定信息变量。

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

-Label

指定图像的新标签。

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

-Language

指定虚拟机或操作系统映像中操作系统的语言。

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

-PrivacyUri

指定指向包含与操作系统映像相关的隐私策略的文档的 URI。

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

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

-PublishedDate

指定将操作系统映像添加到映像存储库的日期。

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

-RecommendedVMSize

指定虚拟机的大小。