Set-AzureVMAccessExtension
Hiermee stelt u de VMAccess-extensie voor een virtuele machine in.
Notitie
De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Syntaxis
Set-AzureVMAccessExtension
[[-UserName] <String>]
[[-Password] <String>]
[[-ReferenceName] <String>]
[[-Version] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMAccessExtension
[-Disable]
[[-ReferenceName] <String>]
[[-Version] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMAccessExtension
[-Uninstall]
[[-ReferenceName] <String>]
[[-Version] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Met de cmdlet Set-AzureVMAccessExtension wordt de VMAccess-extensie van de virtuele machine 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: De VMAccess-extensie instellen die is toegepast op een opgegeven virtuele machine
PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;Met deze opdracht stelt u de VMAccess-extensie in die is toegepast op de opgegeven virtuele machine, zoals opgeslagen in de variabele $VM.
Parameters
-Disable
Geeft aan dat met deze cmdlet de extensiestatus is ingesteld op Uitschakelen.
| Type: | SwitchParameter |
| Position: | 1 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ForceUpdate
Geeft aan dat met deze cmdlet een configuratie opnieuw wordt toegepast op een extensie wanneer de configuratie niet is bijgewerkt.
| Type: | SwitchParameter |
| Position: | 5 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-InformationAction
Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.
De aanvaardbare waarden voor deze parameter zijn:
- Verdergaan
- Negeren
- Vragen
- SilentlyContinue
- Stoppen
- Onderbreken
| Type: | ActionPreference |
| Aliassen: | infa |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-InformationVariable
Hiermee geeft u een informatievariabele op.
| Type: | String |
| Aliassen: | iv |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Password
Hiermee geeft u het wachtwoord op voor het opnieuw instellen van de referenties van de virtuele machine.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Profile
Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ReferenceName
Hiermee geeft u de verwijzingsnaam van de toegangsextensie.
Dit is een door de gebruiker gedefinieerde tekenreeks die wordt gebruikt om te verwijzen naar een extensie. Deze wordt opgegeven wanneer de extensie voor het eerst wordt toegevoegd aan de virtuele machine. Voor volgende updates moet u de eerder gebruikte referentienaam opgeven tijdens het bijwerken van de extensie. De ReferenceName die is toegewezen aan een extensie, wordt geretourneerd met behulp van de Get-AzureVM-cmdlet .
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Uninstall
Hiermee wordt aangegeven of met deze cmdlet de toegangsextensie wordt verwijderd.
| Type: | SwitchParameter |
| Position: | 1 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-UserName
Hiermee geeft u de gebruikersnaam op die door deze cmdlet wordt gebruikt om de referenties van de virtuele machine opnieuw in te stellen.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Version
Hiermee geeft u de versie van de extensie.
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-VM
Hiermee geeft u het permanente virtuele-machineobject.
| Type: | IPersistentVM |
| Aliassen: | InputObject |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |