Set-AzVMAccessExtension

Modul:

Az.Compute

Lägger till VMAccess-tillägget till en virtuell dator.

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

Cmdleten Set-AzVMAccessExtension lägger till VMAccess-tillägget (Virtual Machine Access) 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

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

Det här kommandot lägger till ett VMAccess-tillägg för den virtuella datorn med namnet VirtualMachine07 i ResourceGroup11. Kommandot anger namn och typhanterarversion för VMAccess.

Exempel 2

Lägger till VMAccess-tillägget till en virtuell dator. (automatiskt genererad)

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

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:	AzContext, 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:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-NoWait

Startar åtgärden och returnerar omedelbart innan åtgärden har slutförts. Använd någon annan mekanism för att avgöra om åtgärden har slutförts.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
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-AzVMExtensionImage 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

Indata

PSCredential

String

SwitchParameter

Utdata

PSAzureOperationResponse

Relaterade länkar

• Get-AzVMAccessExtension
• Remove-AzVMAccessExtension
• Set-AzVMExtension
• Get-AzVMExtensionImage