Sdílet prostřednictvím


Set-AzVMBginfoExtension

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

Syntaxe

Set-AzVMBginfoExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzVMBGInfoExtension přidá rozšíření BGInfo do virtuálního počítače.

Příklady

Příklad 1: Přidání rozšíření BGInfo pro virtuální počítač

Set-AzVMBgInfoExtension -ResourceGroupName "ContosoRG" -VMName "ContosoVM" -Name "ExtensionName" -TypeHandlerVersion "2.1" -Location "West Europe"

Tento příkaz přidá rozšíření BGInfo do virtuálního počítače s názvem ContosoVM. Příkaz určuje skupinu prostředků a umístění virtuálního počítače. Příkaz určuje název a verzi rozšíření.

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

-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

Označuje, že tato rutina brání agentu hosta Azure v automatické aktualizaci rozšíření na novější podverzi. Ve výchozím nastavení tato rutina umožňuje agentu hosta aktualizovat rozšíření.

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

-ForceRerun

Určuje, že rozšíření se má spustit znovu se stejným veřejnými nebo chráněnými nastaveními. 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í BGInfo, které tato rutina přidá do virtuálního počítače.

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, do které tato rutina přidá rozšíření.

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é tato rutina přidá do virtuálního počítače.

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, do kterého tato rutina přidá rozšíření BGInfo.

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

Vstupy

String

SwitchParameter

Výstupy

PSAzureOperationResponse