Udostępnij za pośrednictwem

Set-AzureVMAccessExtension

  • Odwołanie
Moduł:
Azure

Ustawia rozszerzenie VMAccess dla maszyny wirtualnej.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Set-AzureVMAccessExtension
   [[-UserName] <String>]
   [[-Password] <String>]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureVMAccessExtension dodaje rozszerzenie VMAccess maszyny wirtualnej 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.

Przykłady

Przykład 1. Ustawianie rozszerzenia VMAccess zastosowanego do określonej maszyny wirtualnej

PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;

To polecenie ustawia rozszerzenie VMAccess zastosowane do określonej maszyny wirtualnej jako przechowywane w zmiennej $VM.

Parametry

-Disable

Wskazuje, że to polecenie cmdlet ustawia stan rozszerzenia na Wartość Wyłącz.

Typ:SwitchParameter
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ForceUpdate

Wskazuje, że to polecenie cmdlet ponownie tworzy konfigurację rozszerzenia, gdy konfiguracja nie została zaktualizowana.

Typ:SwitchParameter
Position:5
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Password

Określa hasło do resetowania poświadczeń maszyny wirtualnej.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReferenceName

Określa nazwę odwołania rozszerzenia dostępu.

Jest to ciąg zdefiniowany przez użytkownika, który jest używany do odwoływania się do rozszerzenia. Jest on określany, gdy rozszerzenie jest dodawane do maszyny wirtualnej po raz pierwszy. W przypadku kolejnych aktualizacji należy określić wcześniej używaną nazwę odwołania podczas aktualizowania rozszerzenia. Nazwa ReferenceName przypisana do rozszerzenia jest zwracana przy użyciu polecenia cmdlet Get-AzureVM .

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Uninstall

Wskazuje, czy to polecenie cmdlet odinstalowuje rozszerzenie dostępu.

Typ:SwitchParameter
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UserName

Określa nazwę użytkownika używaną przez to polecenie cmdlet do resetowania poświadczeń maszyny wirtualnej.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Version

Określa wersję rozszerzenia.

Typ:String
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VM

Określa trwały obiekt maszyny wirtualnej.

Typ:IPersistentVM
Aliasy:InputObject
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False