Set-AzVMAccessExtension

  • Odwołanie
Moduł:
Az.Compute

Dodaje rozszerzenie VMAccess do maszyny wirtualnej.

Składnia

Set-AzVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzVMAccessExtension dodaje rozszerzenie VMAccess maszyny wirtualnej virtual machine access (VMAccess) do maszyny wirtualnej. Rozszerzenie VMAccess może służyć do ustawiania tymczasowego hasła i powinno to zostać natychmiast zmienione po zalogowaniu się do maszyny. Nie jest to obsługiwane na kontrolerach domeny systemu Windows.

Przykłady

Przykład 1. Dodawanie rozszerzenia VMAccess

Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"

To polecenie dodaje rozszerzenie VMAccess dla maszyny wirtualnej o nazwie VirtualMachine07 w grupie ResourceGroup11. Polecenie określa nazwę i wersję programu obsługi typów dla funkcji VMAccess.

Przykład 2

Dodaje rozszerzenie VMAccess do maszyny wirtualnej. (automatycznie wygenerowane)

Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'

Parametry

-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

-Credential

Określa nazwę użytkownika i hasło dla maszyny wirtualnej jako obiekt PSCredential . Jeśli wpiszesz inną nazwę niż bieżące konto administratora lokalnego na maszynie wirtualnej, rozszerzenie VMAccess doda konto administratora lokalnego o tej nazwie i przypisze określone hasło do tego konta. Jeśli konto administratora lokalnego na maszynie wirtualnej istnieje, zresetuje hasło i jeśli konto jest wyłączone, rozszerzenie VMAccess go włącza. Aby uzyskać poświadczenia, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-DisableAutoUpgradeMinorVersion

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

-ForceRerun

Wskazuje, że to polecenie cmdlet wymusza ponowne uruchomienie tej samej konfiguracji rozszerzenia na maszynie wirtualnej bez odinstalowywania i ponownego instalowania rozszerzenia. Wartość może być dowolnym ciągiem innym niż bieżąca wartość. Jeśli element forceUpdateTag nie zostanie zmieniony, aktualizacje ustawień publicznych lub chronionych są nadal stosowane przez program obsługi.

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

-Location

Określa lokalizację maszyny wirtualnej.

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

-Name

Określa nazwę rozszerzenia, które dodaje to polecenie cmdlet.

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:True
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

-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

-TypeHandlerVersion

Określa wersję rozszerzenia do użycia dla tej maszyny wirtualnej. Aby uzyskać wersję, uruchom polecenie cmdlet Get-AzVMExtensionImage z wartością Microsoft.Compute dla parametru PublisherName i vmAccessAgent dla parametru Type . Klasa typeHandlerVersion musi mieć wartość 2.0 lub nowszą, ponieważ wersja 1 jest przestarzała.

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

-VMName

Określa nazwę maszyny wirtualnej. To polecenie cmdlet dodaje funkcję VMAccess dla maszyny wirtualnej, która określa ten parametr.

Type:String
Aliases:ResourceName
Position:1
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

Dane wejściowe

PSCredential

String

SwitchParameter

Dane wyjściowe

PSAzureOperationResponse