Share via

Set-AzVMAccessExtension

  • Reference
Modul:
Az.Compute

Přidá rozšíření VMAccess do virtuálního počítače.

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

Rutina Set-AzVMAccessExtension přidá do virtuálního počítače rozšíření VMAccess (Virtual Machine Access) virtuálního počítače. Rozšíření VMAccess se dá použít k nastavení dočasného hesla a po přihlášení k počítači by se mělo okamžitě změnit. To není podporováno na řadičích domény Windows.

Příklady

Příklad 1: Přidání rozšíření VMAccess

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

Tento příkaz přidá rozšíření VMAccess pro virtuální počítač s názvem VirtualMachine07 v ResourceGroup11. Příkaz určuje název a verzi obslužné rutiny typu pro VMAccess.

Příklad 2

Přidá rozšíření VMAccess do virtuálního počítače. (automaticky vygenerováno)

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Určuje uživatelské jméno a heslo virtuálního počítače jako objekt PSCredential . Pokud na virtuálním počítači zadáte jiný název než aktuální účet místního správce, rozšíření VMAccess přidá účet místního správce s tímto názvem a přiřadí k ho zadanému heslu. Pokud na vašem virtuálním počítači existuje účet místního správce, resetuje heslo a pokud je tento účet zakázaný, rozšíření VMAccess ho povolí. K získání přihlašovacích údajů použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceRerun

Označuje, že tato rutina vynutí opětovné spuštění stejné konfigurace rozšíření na virtuálním počítači bez odinstalace a přeinstalace rozšíření. Hodnota může být libovolný řetězec, který se liší od aktuální hodnoty. Pokud se forceUpdateTag nezmění, aktualizace veřejných nebo chráněných nastavení se stále použijí obslužnou rutinou.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Určuje umístění virtuálního počítače.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje název rozšíření, které tato rutina přidá.

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

Spustí operaci a vrátí se okamžitě před dokončením operace. Pokud chcete zjistit, jestli se operace úspěšně dokončila, použijte jiný mechanismus.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Určuje název skupiny prostředků virtuálního počítače.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Určuje verzi rozšíření, která se má použít pro tento virtuální počítač. Pokud chcete získat verzi, spusťte rutinu Get-AzVMExtensionImage s hodnotou Microsoft.Compute pro parametr PublisherName a VMAccessAgent pro parametr Type . TypeHandlerVersion musí být 2.0 nebo vyšší, protože verze 1 je zastaralá.

Type:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Určuje název virtuálního počítače. Tato rutina přidá VMAccess pro virtuální počítač, který tento parametr určuje.

Type:String
Aliases:ResourceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

PSCredential

String

SwitchParameter

Výstupy

PSAzureOperationResponse