Update-AzVM
Aktualizuje stan maszyny wirtualnej platformy Azure.
Składnia
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>]
Opis
Polecenie cmdlet Update-AzVM aktualizuje stan maszyny wirtualnej platformy Azure do stanu obiektu maszyny wirtualnej.
Przykłady
Przykład 1. Aktualizowanie maszyny wirtualnej
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
To polecenie aktualizuje maszynę wirtualną $VirtualMachine w grupie ResourceGroup11. Polecenie aktualizuje go przy użyciu obiektu maszyny wirtualnej przechowywanego w zmiennej $VirtualMachine. Aby uzyskać obiekt maszyny wirtualnej, użyj polecenia cmdlet Get-AzVM .
Przykład 2. Aktualizowanie maszyny wirtualnej w celu wyłączenia funkcji hyperthreading.
$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.
Parametry
-AsJob
Uruchom polecenie cmdlet w tle i zwróć zadanie, aby śledzić postęp.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CapacityReservationGroupId
Identyfikator grupy rezerwacji pojemności używanej do przydzielenia.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSecureBoot
Określa, czy bezpieczny rozruch powinien być włączony na maszynie wirtualnej.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableVtpm
Określa, czy maszyna wirtualna ma być włączona na maszynie wirtualnej.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionAtHost
Właściwość EncryptionAtHost może być używana przez użytkownika w żądaniu w celu włączenia lub wyłączenia szyfrowania hosta dla maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych. Spowoduje to włączenie szyfrowania dla wszystkich dysków, w tym dysku zasobu/tymczasowego na samym hoście.
Type: | Boolean |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HibernationEnabled
Flaga, która włącza lub wyłącza funkcję hibernacji na maszynie wirtualnej.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HostId
Identyfikator hosta
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Określa identyfikator zasobu maszyny wirtualnej.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IdentityId
Określa listę tożsamości użytkowników skojarzonych z maszyną wirtualną. Odwołania do tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/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
Typ tożsamości używanej dla maszyny wirtualnej. Prawidłowe wartości to SystemAssigned, UserAssigned, SystemAssignedUserAssigned i 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
Określa maksymalną cenę, którą chcesz zapłacić za maszynę wirtualną lub zestaw skalowania maszyn wirtualnych o niskim priorytcie. Ta cena jest wyrażona w dolarach amerykańskich. Ta cena zostanie porównana z bieżącą niską ceną priorytetu dla rozmiaru maszyny wirtualnej. Ponadto ceny są porównywane w momencie tworzenia/aktualizowania maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych o niskim priorytcie, a operacja powiedzie się tylko wtedy, gdy wartość maxPrice jest większa niż bieżąca cena o niskim priorytcie. Wartość maxPrice będzie również używana do eksmitowania maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych o niskim priorytetu, jeśli bieżąca cena o niskim priorytcie wykracza poza wartość maxPrice po utworzeniu maszyny wirtualnej/zestawu skalowania maszyn wirtualnych. Możliwe wartości to: dowolna wartość dziesiętna większa niż zero. Przykład: 0.01538. -1 wskazuje, że maszyna wirtualna o niskim priorycie/zestaw skalowania maszyn wirtualnych nie powinna być wykluczana ze względów cenowych. Ponadto domyślna maksymalna cena to -1, jeśli nie zostanie podana przez Ciebie.
Type: | Double |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoWait
Uruchamia operację i zwraca natychmiast, zanim operacja zostanie ukończona. Aby określić, czy operacja została ukończona pomyślnie, użyj innego mechanizmu.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OsDiskWriteAccelerator
Określa, czy na dysku systemu operacyjnego należy włączyć lub wyłączyć funkcję WriteAccelerator.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProximityPlacementGroupId
Identyfikator zasobu grupy umieszczania w pobliżu do użycia z tą maszyną wirtualną.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Określa nazwę grupy zasobów maszyny wirtualnej.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SecurityType
Określa typ zabezpieczeń maszyny wirtualnej. Należy ustawić dowolną określoną wartość, aby włączyć interfejs Uefi Ustawienia. Domyślnie uefi Ustawienia nie zostanie włączona, chyba że ta właściwość zostanie ustawiona.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Określa zasoby i grupy zasobów można oznaczyć zestawem par nazwa-wartość. Dodawanie tagów do zasobów umożliwia grupowanie zasobów w grupach zasobów i tworzenie własnych widoków. Każdy zasób lub grupa zasobów mogą zawierać maksymalnie 15 tagów.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UltraSSDEnabled
Flaga, która włącza lub wyłącza możliwość posiadania co najmniej jednego dysku danych zarządzanych z UltraSSD_LRS typem konta magazynu na maszynie wirtualnej. Dyski zarządzane z typem konta magazynu UltraSSD_LRS można dodać do maszyny wirtualnej tylko wtedy, gdy ta właściwość jest włączona.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserData
UserData dla maszyny wirtualnej, która będzie zakodowana w formacie base-64. Klient nie powinien przekazywać żadnych wpisów tajnych w tym miejscu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-vCPUCountAvailable
Określa liczbę procesorów wirtualnych dostępnych dla maszyny wirtualnej. Jeśli ta właściwość nie jest określona w treści żądania, domyślne zachowanie polega na ustawieniu jej na wartość procesorów wirtualnych dostępnych dla tego rozmiaru maszyny wirtualnej uwidocznionej w odpowiedzi interfejsu API listy wszystkich dostępnych rozmiarów maszyn wirtualnych w regionie.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-vCPUCountPerCore
Określa stosunek procesorów wirtualnych do fizycznego rdzenia. Jeśli ta właściwość nie zostanie określona w treści żądania, domyślne zachowanie jest ustawione na wartość vCPUsPerCore dla rozmiaru maszyny wirtualnej uwidocznionego w odpowiedzi interfejsu API listy wszystkich dostępnych rozmiarów maszyn wirtualnych w regionie. Ustawienie tej właściwości na 1 oznacza również, że funkcja hyper-threading jest wyłączona.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualMachineScaleSetId
Identyfikator zestawu skalowania maszyn wirtualnych, do którego ma zostać zaktualizowana maszyna wirtualna.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Określa lokalny obiekt maszyny wirtualnej. Aby uzyskać obiekt maszyny wirtualnej, użyj polecenia cmdlet Get-AzVM. Ten obiekt maszyny wirtualnej zawiera zaktualizowany stan maszyny wirtualnej.
Type: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |