Set-AzureVMAccessExtension

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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

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

-ForceUpdate

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

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortfahren
  • Ignorieren
  • Fragen
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

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

-Password

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

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

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Uninstall

Gibt an, ob dieses Cmdlet die Zugriffserweiterung deinstalliert.

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

-UserName

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

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

-Version

Gibt die Version der Erweiterung an.

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

-VM

Gibt das objekt des beständigen virtuellen Computers an.

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