Update-AzVM

模組:

Az.Compute

更新 Azure 虛擬機器的狀態。

語法

Update-AzVM
      [-ResourceGroupName] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-UltraSSDEnabled <Boolean>]
      [-MaxPrice <Double>]
      [-EncryptionAtHost <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-VirtualMachineScaleSetId <String>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-SecurityType <String>]
      [-EnableVtpm <Boolean>]
      [-EnableSecureBoot <Boolean>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzVM
      [-ResourceGroupName] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      -IdentityType <ResourceIdentityType>
      [-IdentityId <String[]>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-UltraSSDEnabled <Boolean>]
      [-MaxPrice <Double>]
      [-EncryptionAtHost <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-VirtualMachineScaleSetId <String>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-SecurityType <String>]
      [-EnableVtpm <Boolean>]
      [-EnableSecureBoot <Boolean>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzVM
      [-Id] <String>
      -VM <PSVirtualMachine>
      [-Tag <Hashtable>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-UltraSSDEnabled <Boolean>]
      [-MaxPrice <Double>]
      [-EncryptionAtHost <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-VirtualMachineScaleSetId <String>]
      [-HostId <String>]
      [-CapacityReservationGroupId <String>]
      [-AsJob]
      [-NoWait]
      [-UserData <String>]
      [-HibernationEnabled]
      [-vCPUCountAvailable <Int32>]
      [-vCPUCountPerCore <Int32>]
      [-SecurityType <String>]
      [-EnableVtpm <Boolean>]
      [-EnableSecureBoot <Boolean>]
      [-IfMatch <String>]
      [-IfNoneMatch <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-AzVM Cmdlet 會將 Azure 虛擬機的狀態更新為虛擬機物件的狀態。

範例

範例 1：更新虛擬機

Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

此命令會更新 ResourceGroup11 中的虛擬機$VirtualMachine。 命令會使用儲存在 $VirtualMachine 變數中的虛擬機物件來更新它。 若要取得虛擬機物件，請使用 Get-AzVM Cmdlet。

範例 2：更新虛擬機以停用超線程。

$resourceGroupName = 'Resource Group Name>'
$vmname = 'Virtual Machine Name';
$domainNameLabel = "d1" + $rgname;
$vCPUsCoreInitial = 2;
$vCPUsAvailableInitial = 4;
$vCPUsCore1 = 1;
$vCPUsAvailable1 = 1;
$vmSize = 'Standard_D4s_v4';

$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = "user";
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -Size $vmSize -vCPUCountPerCore $vCPUsCoreInitial -vCPUCountAvailable $vCPUsAvailableInitial;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 2, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 4.

Update-AzVM -ResourceGroupName $rgname -VM $vm -vCPUCountAvailable $vCPUsAvailable1 -vCPUCountPerCore $vCPUsCore1;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 1, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 1. 
# Hyperthreading is now disabled for this VM.

參數

-AsJob

在背景執行 Cmdlet，並傳回作業以追蹤進度。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CapacityReservationGroupId

用來配置的容量保留群組標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableSecureBoot

指定是否應在虛擬機上啟用安全開機。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EnableVtpm

指定是否應在虛擬機上啟用 vTPM。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EncryptionAtHost

加密AtHost 屬性可由要求中的用戶用來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。

類型:	Boolean
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HibernationEnabled

啟用或停用 VM 上休眠功能的旗標。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-HostId

主機的標識碼

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Id

指定虛擬機的資源識別碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-IdentityId

指定與虛擬機相關聯的使用者身分識別清單。 使用者身分識別參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityType

用於虛擬機的身分識別類型。 有效值為 SystemAssigned、UserAssigned、SystemAssignedUserAssigned 和 None。

類型:	Nullable<T>[ResourceIdentityType]
接受的值:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-IfMatch

用來為 PUT 和其他非安全方法提出要求條件。 只有當資源符合其中一個列出的 ETag 值時，伺服器才會傳回所要求的資源。 請省略此值以一律覆寫目前的資源。 指定最後看到的 ETag 值，以防止意外覆寫並行變更。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-IfNoneMatch

用來為 GET 和 HEAD 方法提出要求條件。 如果列出的 ETag 值與目前的實體不相符，則伺服器只會傳回所要求的資源。 用來為 GET 和 HEAD 方法提出要求條件。 如果列出的 ETag 值與目前的實體不相符，則伺服器只會傳回所要求的資源。 設定為 『*』 以允許建立新的記錄集，但為了避免更新現有的記錄集。 其他值會導致伺服器發生錯誤，因為它們不受支援。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-MaxPrice

指定您願意支付低優先順序 VM/VMSS 的最高價格。 這個價格以美元為單位。 此價格會與 VM 大小的目前低優先順序價格進行比較。 此外，價格會在建立/更新低優先順序 VM/VMSS 時進行比較，只有在 maxPrice 大於目前的低優先順序價格時，作業才會成功。 如果目前的低優先順序價格超出建立 VM/VMSS 之後的 maxPrice，maxPrice 也會用於收回低優先順序的 VM/VMSS。 可能的值為：任何大於零的十進位值。 範例：0.01538。 -1 表示基於價格原因，不應收回低優先順序的 VM/VMSS。 此外，如果預設的最大價格不是由您提供，則為 -1。

類型:	Double
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-NoWait

啟動作業，並在作業完成之前立即傳回。 若要判斷作業是否已順利完成，請使用一些其他機制。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OsDiskWriteAccelerator

指定OS磁碟上是否應啟用或停用 WriteAccelerator。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProximityPlacementGroupId

要與這個虛擬機搭配使用的鄰近放置群組的資源標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

指定虛擬機的資源群組名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SecurityType

指定虛擬機的 SecurityType。 它必須設定為任何指定的值，才能啟用 UefiSettings。 根據預設，除非設定此屬性，否則不會啟用 UefiSettings。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Tag

指定可以使用一組名稱/值組來標記資源和資源群組。 將標籤新增至資源可讓您跨資源群組將資源群組在一起，並建立您自己的檢視。 每個資源或資源群組最多可以有15個標籤。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UltraSSDEnabled

旗標，可啟用或停用在 VM 上具有一或多個具有記憶體帳戶類型之UltraSSD_LRS受控數據磁碟的功能。 只有啟用此屬性，才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UserData

VM 的 UserData，其會以base-64編碼。 客戶不應在此傳遞任何秘密。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-vCPUCountAvailable

指定 VM 可用的 vCPU 數目。 當要求本文中未指定此屬性時，預設行為是將它設定為 API 回應 中公開之 VM 大小的 vCPU 值，以列出區域中所有可用的虛擬機大小。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-vCPUCountPerCore

指定 vCPU 與實體核心比率。 當要求本文中未指定這個屬性時，預設行為會設定為 vCPUUsPerCore 的值，以取得在區域中列出所有可用虛擬機大小的 API 回應中公開的 VM 大小。 將此屬性設定為 1 也表示已停用超線程處理。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-VirtualMachineScaleSetId

虛擬機器 ScaleSet 的識別碼，虛擬機器應該更新為 。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VM

指定本機虛擬機物件。 若要取得虛擬機物件，請使用 Get-AzVM Cmdlet。 此虛擬機物件包含虛擬機的更新狀態。

類型:	PSVirtualMachine
別名:	VMProfile
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

PSVirtualMachine

Boolean

輸出

PSAzureOperationResponse

相關連結

• Get-AzVM
• New-AzVM
• Remove-AzVM
• Restart-AzVM
• Start-AzVM
• Stop-AzVM
• New-AzVMConfig