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>]
[-NoWait]
[-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. 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. De opdracht geeft de naam en type handler-versie voor VMAccess.
Voorbeeld 2
Hiermee voegt u 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 |
| 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 .
Als u een andere naam typt dan het huidige lokale beheerdersaccount op uw virtuele machine, 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 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: | AzContext, 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: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| 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 . De typeHandlerVersion moet 2.0 of hoger zijn, omdat versie 1 is afgeschaft.
| 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 |