你当前正在访问 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 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

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
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskConfig

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

类型:	VirtualMachineImageDiskConfigSet
Position:	8
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DontShowInGui

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

类型:	SwitchParameter
Position:	12
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Eula

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

类型:	String
Position:	2
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IconName

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

类型:	String
Aliases:	IconUri
Position:	10
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ImageFamily

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

类型:	String
Position:	4
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ImageName

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

类型:	String
Position:	0
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

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

此参数的可接受值为：

继续
忽略
询问
SilentlyContinue
停止
Suspend

类型:	ActionPreference
Aliases:	infa
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

指定信息变量。

类型:	String
Aliases:	iv
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Label

指定图像的新标签。

类型:	String
Position:	1
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Language

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

类型:	String
Position:	9
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PrivacyUri

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

类型:	Uri
Position:	6
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

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

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublishedDate

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

类型:	DateTime
Position:	5
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RecommendedVMSize

指定虚拟机的大小。