Delen via


Set-AzVMAccessExtension

Hiermee voegt u de VMAccess-extensie toe aan een virtuele machine.

Syntaxis

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

Description

Met de cmdlet Set-AzVMAccessExtension wordt de VMAccess-extensie virtual machine (Virtual Machine Access) toegevoegd aan een virtuele machine. VMAccess-extensie kan worden gebruikt om een tijdelijk wachtwoord in te stellen en dit moet onmiddellijk worden gewijzigd nadat u zich hebt aangemeld bij de computer.

Voorbeelden

Voorbeeld 1: Een VMAccess-extensie toevoegen

PS C:\> Set-AzVMAccessExtension -ResourceGroupName "ResrouceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.0" -UserName "PFuller" -Password "Password"

Met deze opdracht wordt een VMAccess-extensie toegevoegd voor de virtuele machine met de naam VirtualMachine07 in ResrouceGroup11. De opdracht geeft de naam en type handler-versie voor VMAccess.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor de virtuele machine op als een PSCredential-object . Gebruik de cmdlet Get-Credential om een referentie te verkrijgen. Typ voor meer informatie Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableAutoUpgradeMinorVersion

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ForceRerun

Geeft aan dat met deze cmdlet dezelfde extensieconfiguratie op de virtuele machine opnieuw wordt uitgevoerd zonder de extensie te verwijderen en opnieuw te installeren. De waarde kan elke tekenreeks zijn die verschilt van de huidige waarde.

Als forceUpdateTag niet wordt gewijzigd, worden updates voor openbare of beveiligde instellingen nog steeds toegepast door de handler.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de extensie die door deze cmdlet wordt toegevoegd.

Type:String
Aliassen:ExtensionName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TypeHandlerVersion

Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine. Als u de versie wilt ophalen, voert u de cmdlet Get-AzVMExtensionImage uit met de waarde Microsoft.Compute voor de parameter PublisherName en VMAccessAgent voor de parameter Type .

Type:String
Aliassen:HandlerVersion, Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

Hiermee geeft u de naam van een virtuele machine. Met deze cmdlet wordt VMAccess toegevoegd voor de virtuele machine die met deze parameter wordt opgegeven.

Type:String
Aliassen:ResourceName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert.

De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

PSAzureOperationResponse