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 für virtuelle Computer (Virtual Machine Access, 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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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 dem virtuellen Computer eingeben, fügt die VMAccess-Erweiterung ein lokales Administratorkonto mit diesem Namen hinzu und weist diesem Konto das angegebene Kennwort zu. Wenn das lokale Administratorkonto auf dem virtuellen Computer vorhanden ist, wird das Kennwort zurückgesetzt, und wenn es deaktiviert ist, wird es durch die VMAccess-Erweiterung aktiviert. Verwenden Sie zum Abrufen einer Anmeldeinformationen das Cmdlet Get-Credential. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutoUpgradeMinorVersion

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

-ForceRerun

Gibt an, dass dieses Cmdlet eine erneute Ausführung derselben Erweiterungskonfiguration auf dem virtuellen Computer erzwingt, ohne die Erweiterung zu deinstallieren und erneut 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.

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

-Location

Gibt den Speicherort des virtuellen Computers an.

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

-Name

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

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

-NoWait

Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Verwenden Sie einen anderen Mechanismus, um zu ermitteln, ob der Vorgang erfolgreich abgeschlossen wurde.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-TypeHandlerVersion

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

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

-VMName

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

PSCredential

String

SwitchParameter

Ausgaben

PSAzureOperationResponse