Sdílet prostřednictvím

Set-AzureVMAccessExtension

  • Reference
Modul:
Azure

Nastaví rozšíření VMAccess pro virtuální počítač.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Rutina Set-AzureVMAccessExtension přidá do virtuálního počítače rozšíření VMAccess 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.

Příklady

Příklad 1: Nastavení rozšíření VMAccess použité na zadaný virtuální počítač

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

Tento příkaz nastaví rozšíření VMAccess použité na zadaný virtuální počítač jako uložené v proměnné $VM.

Parametry

-Disable

Označuje, že tato rutina nastaví stav rozšíření na zakázání.

Typ:SwitchParameter
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ForceUpdate

Označuje, že tato rutina znovu použije konfiguraci rozšíření v případě, že konfigurace nebyla aktualizována.

Typ:SwitchParameter
Position:5
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliasy:iv
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Password

Určuje heslo pro resetování přihlašovacích údajů virtuálního počítače.

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:AzureSMProfile
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ReferenceName

Určuje název odkazu rozšíření přístupu.

Jedná se o uživatelem definovaný řetězec, který slouží k odkazování na rozšíření. Určuje se při prvním přidání rozšíření do virtuálního počítače. V případě následných aktualizací byste při aktualizaci rozšíření měli zadat dříve použitý název odkazu. ReferenceName přiřazené k rozšíření se vrátí pomocí rutiny Get-AzureVM.

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Uninstall

Určuje, jestli tato rutina odinstaluje rozšíření přístupu.

Typ:SwitchParameter
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserName

Určuje uživatelské jméno, které tato rutina používá k resetování přihlašovacích údajů virtuálního počítače.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Version

Určuje verzi rozšíření.

Typ:String
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VM

Určuje trvalý objekt virtuálního počítače.

Typ:IPersistentVM
Aliasy:InputObject
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False