Dela via


Set-AzureVMAccessExtension

Anger VMAccess-tillägget för en virtuell dator.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Syntax

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

Cmdleten Set-AzureVMAccessExtension lägger till VMAccess-tillägget för virtuell dator 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.

Exempel

Exempel 1: Ange VMAccess-tillägget som tillämpas på en angiven virtuell dator

PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;

Det här kommandot anger VMAccess-tillägget som tillämpas på den angivna virtuella datorn som lagras i variabeln $VM.

Parametrar

-Disable

Anger att den här cmdleten anger tilläggets tillstånd till Inaktivera.

Typ:SwitchParameter
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ForceUpdate

Anger att den här cmdleten återställer en konfiguration till ett tillägg när konfigurationen inte har uppdaterats.

Typ:SwitchParameter
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Alias:infa
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Alias:iv
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Password

Anger lösenordet för att återställa den virtuella datorns autentiseringsuppgifter.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReferenceName

Anger referensnamnet för åtkomsttillägget.

Det här är en användardefinierad sträng som används för att referera till ett tillägg. Det anges när tillägget läggs till i den virtuella datorn för första gången. För efterföljande uppdateringar bör du ange det tidigare använda referensnamnet när du uppdaterar tillägget. Referensnamnet som tilldelats ett tillägg returneras med cmdleten Get-AzureVM.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Uninstall

Anger om den här cmdleten avinstallerar åtkomsttillägget.

Typ:SwitchParameter
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UserName

Anger det användarnamn som den här cmdleten använder för att återställa den virtuella datorns autentiseringsuppgifter.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Version

Anger versionen av tillägget.

Typ:String
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VM

Anger objektet för den beständiga virtuella datorn.

Typ:IPersistentVM
Alias:InputObject
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False