Update-AzVM

參考

模組:: Az.Compute

更新 Azure 虛擬機器的狀態。

Syntax

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>]
      [-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>]
      [-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>]
      [-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 = 'Password' | ConvertTo-SecureString -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，並傳回作業以追蹤進度。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapacityReservationGroupId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableSecureBoot

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableVtpm

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

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EncryptionAtHost

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

Type:	Boolean
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HibernationEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-HostId

主機的標識碼

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityId

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

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

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPrice

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

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NoWait

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OsDiskWriteAccelerator

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProximityPlacementGroupId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SecurityType

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UltraSSDEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserData

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-vCPUCountAvailable

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-vCPUCountPerCore

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualMachineScaleSetId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

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

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

String

PSVirtualMachine

Boolean

輸出

PSAzureOperationResponse

Update-AzVM

Syntax

Description

範例

範例 1：更新虛擬機

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

參數

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

輸入

輸出

意見反應

其他資源

Update-AzVM

Syntax

Description

範例

範例 1：更新虛擬機

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

參數

-AsJob

-CapacityReservationGroupId

-Confirm

-DefaultProfile

-EnableSecureBoot

-EnableVtpm

-EncryptionAtHost

-HibernationEnabled

-HostId

-Id

-IdentityId

-IdentityType

-MaxPrice

-NoWait

-OsDiskWriteAccelerator

-ProximityPlacementGroupId

-ResourceGroupName

-SecurityType

-Tag

-UltraSSDEnabled

-UserData

-vCPUCountAvailable

-vCPUCountPerCore

-VirtualMachineScaleSetId

-VM

-WhatIf

輸入

輸出

相關連結

意見反應

其他資源