你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Update-AzureVMImage
更新映像存储库中操作系统映像的标签。
注意
本文档中引用的 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 |
接受管道输入: | 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
指定虚拟机的大小。
此参数的可接受值为:
- 中
- 大型
- 特大
- A5
- A6
- A7
类型: | String |
Position: | 7 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-SmallIconName
指定操作系统或虚拟机映像的小型图标名称。
类型: | String |
别名: | SmallIconUri |
Position: | 11 |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
输出
OSImageContext