Set-AzVMAccessExtension

Referentie

Module:: Az.Compute

Voegt de VMAccess-extensie toe aan een virtuele machine.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

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

Description

Met de cmdlet Set-AzVMAccessExtension wordt de VMAccess-extensie virtuele 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. Dit wordt niet ondersteund op Windows-domeincontrollers.

Voorbeelden

Voorbeeld 1: Een VMAccess-extensie toevoegen

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

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

Voorbeeld 2

Voegt de VMAccess-extensie toe aan een virtuele machine. (automatisch gegenereerd)

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

Parameters

-Confirm

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

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

-Credential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor de virtuele machine op als een PSCredential-object . Als u een andere naam typt dan het huidige lokale beheerdersaccount op uw VM, voegt de VMAccess-extensie een lokaal beheerdersaccount met die naam toe en wijst u uw opgegeven wachtwoord toe aan dat account. Als het lokale beheerdersaccount op uw VIRTUELE machine bestaat, wordt het wachtwoord opnieuw ingesteld en als het account is uitgeschakeld, wordt dit door de VMAccess-extensie ingeschakeld. Gebruik de Get-Credential cmdlet om een referentie te verkrijgen. Typ Get-Help Get-Credential voor meer informatie.

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

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

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 een andere tekenreeks zijn dan 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
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Hiermee geeft u de locatie van de virtuele machine.

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

-Name

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

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

-NoWait

Start de bewerking en retourneert onmiddellijk, voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.

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

-ResourceGroupName

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

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

-TypeHandlerVersion

Hiermee geeft u de versie van de extensie die moet worden gebruikt voor deze virtuele machine. Als u de versie wilt verkrijgen, voert u de Get-AzVMExtensionImage cmdlet uit met de waarde Microsoft.Compute voor de parameter PublisherName en VMAccessAgent voor de parameter Type . De typeHandlerVersion moet 2.0 of hoger zijn, omdat versie 1 is afgeschaft.

Type:	String
Aliases:	HandlerVersion, Version
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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.