Freigeben über

Set-AzVMAccessExtension

  • Referenz
Modul:
Az.Compute

Fügt die VMAccess-Erweiterung zu einem virtuellen Computer hinzu.

Syntax

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

Beschreibung

Das cmdlet Set-AzVMAccessExtension fügt die VMAccess-Erweiterung des virtuellen Computers vmAccess 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. Dies wird auf Windows-Domänencontrollern nicht unterstützt.

Beispiele

Beispiel 1: Hinzufügen einer VMAccess-Erweiterung

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

Dieser Befehl fügt eine VMAccess-Erweiterung für den virtuellen Computer namens VirtualMachine07 in ResourceGroup11 hinzu. Der Befehl gibt den Namen und die Typhandlerversion für VMAccess an.

Beispiel 2

Fügt die VMAccess-Erweiterung zu einem virtuellen Computer hinzu. (automatisch generiert)

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt den Benutzernamen und das Kennwort für den virtuellen Computer als PSCredential -Objekt an. Wenn Sie einen anderen Namen als das aktuelle lokale Administratorkonto auf Ihrem virtuellen Computer eingeben, fügt die VMAccess-Erweiterung ein lokales Administratorkonto mit diesem Namen hinzu und weisen Ihr angegebenes Kennwort diesem Konto zu. Wenn das lokale Administratorkonto auf Ihrem virtuellen Computer vorhanden ist, wird das Kennwort zurückgesetzt, und wenn das Konto deaktiviert ist, aktiviert die VMAccess-Erweiterung es. Verwenden Sie das Cmdlet Get-Credential, um anmeldeinformationen zu erhalten. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableAutoUpgradeMinorVersion

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

-ForceRerun

Gibt an, dass dieses Cmdlet eine erneute Ausführung derselben Erweiterungskonfiguration auf dem virtuellen Computer erzwingt, ohne die Erweiterung zu deinstallieren und neu zu installieren. Der Wert kann eine beliebige Zeichenfolge sein, die sich vom aktuellen Wert unterscheidet. Wenn forceUpdateTag nicht geändert wird, werden Updates für öffentliche oder geschützte Einstellungen weiterhin vom Handler angewendet.

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

-Location

Gibt den Speicherort des virtuellen Computers an.

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

-Name

Gibt den Namen der Erweiterung an, die dieses Cmdlet hinzufügt.

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

-NoWait

Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Um festzustellen, ob der Vorgang erfolgreich abgeschlossen wurde, verwenden Sie einen anderen Mechanismus.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-TypeHandlerVersion

Gibt die Version der Erweiterung an, die für diesen virtuellen Computer verwendet werden soll. Führen Sie zum Abrufen der Version das cmdlet Get-AzVMExtensionImage mit dem Wert "Microsoft.Compute" für den PublisherName-Parameter und vmAccessAgent für den parameter Type aus. Die typeHandlerVersion muss 2.0 oder höher sein, da Version 1 veraltet ist.

Typ:String
Aliase:HandlerVersion, Version
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMName

Gibt den Namen eines virtuellen Computers an. Dieses Cmdlet fügt VMAccess für den virtuellen Computer hinzu, den dieser Parameter angibt.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSCredential

String

SwitchParameter

Ausgaben

PSAzureOperationResponse