Update-AzureVMImage
更新映像存放庫中操作系統映像的標籤。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （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>] Description
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 的所有作業系統映像，並將標籤變更為 Updated。
參數
-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
- 停止
- 暫止
| 類型: | 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