共用方式為


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,並傳回作業以追蹤進度。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Generalized

表示此 Cmdlet 將虛擬機器標示為一般化。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

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

在作業完成之前啟動作業並立即傳回。 為了確定操作是否已成功完成,請使用其他一些機制。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

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

重新套用虛擬機器。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ReapplyResourceGroupNameParameterSetName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
ReapplyIdParameterSetName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Redeploy

表示此 Cmdlet 會手動將虛擬機器重新部署至不同的 Azure 主機,以修正任何問題。 如果您重新部署虛擬機器,它會重新啟動,這會導致暫時磁碟機資料遺失。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

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 分鐘內發生。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

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

輸入

String

輸出

PSComputeLongRunningOperation

PSAzureOperationResponse