Set-AzVM
此 Cmdlet 可用來執行下列動作:重新套用或重新部署虛擬機器、將虛擬機器標示為一般化、模擬收回至現成虛擬機器。
語法
GeneralizeResourceGroupNameParameterSetName (預設值)
Set-AzVM
[-ResourceGroupName] <String>
[-Name] <String>
[-Generalized]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedeployResourceGroupNameParameterSetName
Set-AzVM
[-ResourceGroupName] <String>
[-Name] <String>
[-Redeploy]
[-AsJob]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ReapplyResourceGroupNameParameterSetName
Set-AzVM
[-ResourceGroupName] <String>
[-Name] <String>
[-Reapply]
[-AsJob]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SimulateEvictionResourceGroupNameParameterSetName
Set-AzVM
[-ResourceGroupName] <String>
[-Name] <String>
[-SimulateEviction]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GeneralizeIdParameterSetName
Set-AzVM
[-Id] <String>
[-Generalized]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedeployIdParameterSetName
Set-AzVM
[-Id] <String>
[-Redeploy]
[-AsJob]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ReapplyIdParameterSetName
Set-AzVM
[-Id] <String>
[-Reapply]
[-AsJob]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SimulateEvictionIdParameterSetName
Set-AzVM
[-Id] <String>
[-SimulateEviction]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzVM Cmdlet 可用來重新部署或重新套用虛擬機器。 它也可用來將虛擬機器標示為一般化,或模擬收回到現成虛擬機器。
在將虛擬機器標示為一般化之前,請登入虛擬機器,並使用 Sysprep 來準備硬碟。 如需詳細資訊,請參閱 此處 。
範例
範例 1:將虛擬機器標示為一般化
Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized
此命令將名為「VirtualMachine07」的虛擬機器標記為通用。
範例 2:使用資源 ID 模擬收回至現貨虛擬機器
$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -SimulateEviction
此命令會使用資源識別碼模擬收回名為「VirtualMachine07」的虛擬機器。
範例 3:重新套用虛擬機器
Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Reapply
此命令會重新套用名為「VirtualMachine07」的虛擬機器。
範例 4:使用資源識別碼重新部署虛擬機器
$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -Redeploy
此命令會使用資源識別碼部署名為「VirtualMachine07」的虛擬機器。
參數
-AsJob
在背景中執行 Cmdlet,並傳回作業以追蹤進度。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Generalized
表示此 Cmdlet 將虛擬機器標示為一般化。
參數屬性
參數集
GeneralizeResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
GeneralizeIdParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定虛擬機器的資源識別碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GeneralizeIdParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
RedeployIdParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ReapplyIdParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
SimulateEvictionIdParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定此 Cmdlet 運作的虛擬機器名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GeneralizeResourceGroupNameParameterSetName
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
RedeployResourceGroupNameParameterSetName
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ReapplyResourceGroupNameParameterSetName
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
SimulateEvictionResourceGroupNameParameterSetName
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NoWait
在作業完成之前啟動作業並立即傳回。 為了確定操作是否已成功完成,請使用其他一些機制。
參數屬性
參數集
RedeployResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ReapplyResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
RedeployIdParameterSetName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ReapplyIdParameterSetName
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Reapply
重新套用虛擬機器。
參數屬性
參數集
ReapplyResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ReapplyIdParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Redeploy
表示此 Cmdlet 會手動將虛擬機器重新部署至不同的 Azure 主機,以修正任何問題。
如果您重新部署虛擬機器,它會重新啟動,這會導致暫時磁碟機資料遺失。
參數屬性
參數集
RedeployResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
RedeployIdParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定虛擬機器資源群組的名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GeneralizeResourceGroupNameParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
RedeployResourceGroupNameParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
ReapplyResourceGroupNameParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
SimulateEvictionResourceGroupNameParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SimulateEviction
表示此 Cmdlet 會模擬收回現成虛擬機器。
收回將在呼叫 API 後的 30 分鐘內發生。
參數屬性
參數集
SimulateEvictionResourceGroupNameParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
SimulateEvictionIdParameterSetName
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出