Freigeben über

Set-AzureVMAccessExtension

  • Referenz
Modul:
Azure

Legt die VMAccess-Erweiterung für einen virtuellen Computer fest.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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>]

Beschreibung

Das Cmdlet Set-AzureVMAccessExtension fügt die VMAccess-Erweiterung des virtuellen Computers zu einem virtuellen Computer hinzu. VMAccess-Erweiterung kann verwendet werden, um ein temporäres Kennwort festzulegen, und dies sollte nach der Anmeldung beim Computer sofort geändert werden.

Beispiele

Beispiel 1: Festlegen der VMAccess-Erweiterung, die auf einen angegebenen virtuellen Computer angewendet wird

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

Mit diesem Befehl wird die VMAccess-Erweiterung festgelegt, die auf den angegebenen virtuellen Computer angewendet wird, wie in der Variablen $VM gespeichert.

Parameter

-Disable

Gibt an, dass dieses Cmdlet den Erweiterungsstatus auf "Deaktivieren" festlegt.

Typ:SwitchParameter
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ForceUpdate

Gibt an, dass dieses Cmdlet eine Konfiguration auf eine Erweiterung anwendet, wenn die Konfiguration nicht aktualisiert wurde.

Typ:SwitchParameter
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

Gibt das Kennwort zum Zurücksetzen der Anmeldeinformationen des virtuellen Computers an.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReferenceName

Gibt den Verweisnamen der Access-Erweiterung an.

Dies ist eine benutzerdefinierte Zeichenfolge, die verwendet wird, um auf eine Erweiterung zu verweisen. Sie wird angegeben, wenn die Erweiterung zum ersten Mal dem virtuellen Computer hinzugefügt wird. Bei nachfolgenden Updates sollten Sie beim Aktualisieren der Erweiterung den zuvor verwendeten Verweisnamen angeben. Der einer Erweiterung zugewiesene Verweisname wird mithilfe des Cmdlets "Get-AzureVM " zurückgegeben.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Uninstall

Gibt an, ob dieses Cmdlet die Zugriffserweiterung deinstalliert.

Typ:SwitchParameter
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UserName

Gibt den Benutzernamen an, den dieses Cmdlet zum Zurücksetzen der Anmeldeinformationen des virtuellen Computers verwendet.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Version

Gibt die Version der Erweiterung an.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt das objekt des beständigen virtuellen Computers an.

Typ:IPersistentVM
Aliase:InputObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False