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
Výstupy
Azure PowerShell