Set-AzureRmVMAccessExtension
Lägger till VMAccess-tillägget till en virtuell dator.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
Syntax
Set-AzureRmVMAccessExtension
[-Credential <PSCredential>]
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Set-AzureRmVMAccessExtension lägger till VMAccess(Virtual Machine Access) VMAccess-tillägget till en virtuell dator. VMAccess-tillägget kan användas för att ange ett tillfälligt lösenord och detta bör omedelbart ändras när du har loggat in på datorn. Detta stöds inte på Windows-domänkontrollanter.
Exempel
Exempel 1: Lägg till ett VMAccess-tillägg
PS C:\> Set-AzureRmVMAccessExtension -ResourceGroupName "ResrouceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4" -UserName "PFuller" -Password "Password"
Det här kommandot lägger till ett VMAccess-tillägg för den virtuella datorn med namnet VirtualMachine07 i ResrouceGroup11. Kommandot anger namn och typhanterarversion för VMAccess.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Typ: | SwitchParameter |
Alias: | cf |
Position: | Named |
Standardvärde: | False |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Credential
Anger användarnamnet och lösenordet för den virtuella datorn som ett PSCredential-objekt .
Om du skriver ett annat namn än det aktuella lokala administratörskontot på den virtuella datorn lägger TILLÄGGET VMAccess till ett lokalt administratörskonto med det namnet och tilldelar det angivna lösenordet till kontot. Om det lokala administratörskontot på den virtuella datorn finns återställs lösenordet och om kontot är inaktiverat aktiverar VMAccess-tillägget det.
Om du vill hämta en autentiseringsuppgift använder du cmdleten Get-Credential.
Om du vill ha mer information skriver du Get-Help Get-Credential
.
Typ: | PSCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DisableAutoUpgradeMinorVersion
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-ForceRerun
Anger att denna cmdlet tvingar fram en omkörning av samma tilläggskonfiguration på den virtuella datorn utan att avinstallera och installera om tillägget. Värdet kan vara valfri sträng som skiljer sig från det aktuella värdet. Om forceUpdateTag inte ändras tillämpas uppdateringar av offentliga eller skyddade inställningar fortfarande av hanteraren.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Location
Anger platsen för den virtuella datorn.
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Name
Anger namnet på tillägget som den här cmdleten lägger till.
Typ: | String |
Alias: | ExtensionName |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-ResourceGroupName
Anger namnet på resursgruppen för den virtuella datorn.
Typ: | String |
Position: | 0 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-TypeHandlerVersion
Anger vilken version av tillägget som ska användas för den här virtuella datorn. Hämta versionen genom att köra cmdleten Get-AzureRmVMExtensionImage med värdet Microsoft.Compute för parametern PublisherName och VMAccessAgent för parametern Type . TypeHandlerVersion måste vara 2.0 eller senare, eftersom version 1 är inaktuell.
Typ: | String |
Alias: | HandlerVersion, Version |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-VMName
Anger namnet på en virtuell dator. Den här cmdleten lägger till VMAccess för den virtuella datorn som den här parametern anger.
Typ: | String |
Alias: | ResourceName |
Position: | 1 |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Typ: | SwitchParameter |
Alias: | wi |
Position: | Named |
Standardvärde: | False |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |