Set-AzVMAccessExtension
Přidá rozšíření VMAccess do virtuálního počítače.
Syntaxe
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í.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DisableAutoUpgradeMinorVersion
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Location
Určuje umístění virtuálního počítače.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název rozšíření, které tato rutina přidá.
| Typ: | String |
| Aliasy: | ExtensionName |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků virtuálního počítače.
| Typ: | String |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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á.
| Typ: | String |
| Aliasy: | HandlerVersion, Version |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | String |
| Aliasy: | ResourceName |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |