Megosztás a következőn keresztül:

Set-AzVMExtension

  • Referencia
Modul:
Az.Compute

Frissíti a bővítmény tulajdonságait, vagy bővítményt ad hozzá egy virtuális géphez.

Syntax

Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-Settings <Hashtable>]
   [-ProtectedSettings <Hashtable>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-SettingString <String>]
   [-ProtectedSettingString <String>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A Set-AzVMExtension parancsmag frissíti a meglévő virtuálisgép-bővítmények tulajdonságait, vagy bővítményt ad hozzá egy virtuális géphez.

Példák

1. példa: Beállítások módosítása kivonattáblák használatával

$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -Settings $Settings -ProtectedSettings $ProtectedSettings;

Az első két parancs szabványos Windows PowerShell-szintaxist használ kivonattáblák létrehozásához, majd ezeket a kivonattáblákat a $Settings és $ProtectedSettings változókban tárolja. További információkért írja be a következőt Get-Help about_Hash_Tables: A második parancs két korábban létrehozott és változóban tárolt értéket tartalmaz. Az utolsó parancs módosítja a VirtualMachine22 nevű virtuális gép bővítményét a ResourceGroup11-ben a $Settings és a $ProtectedSettings tartalma szerint. A parancs a közzétevőt és a bővítménytípust is tartalmazó egyéb szükséges információkat adja meg.

2. példa: Beállítások módosítása sztringek használatával

$SettingsString = '{"fileUris":[],"commandToExecute":""}';
$ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -SettingString $SettingsString -ProtectedSettingString $ProtectedSettingsString ;

Az első két parancs beállításokat tartalmazó sztringeket hoz létre, majd a $SettingsString és $ProtectedSettingsString változókban tárolja őket. Az utolsó parancs módosítja a VirtualMachine22 nevű virtuális gép bővítményét a ResourceGroup11-ben a $SettingsString és a $ProtectedSettingsString tartalma szerint. A parancs a közzétevőt és a bővítménytípust is tartalmazó egyéb szükséges információkat adja meg.

Paraméterek

-AsJob

Parancsmag futtatása a háttérben

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DisableAutoUpgradeMinorVersion

Ez a parancsmag megakadályozza, hogy az Azure-vendégügynök automatikusan frissítse a bővítményeket egy újabb alverzióra. Ez a parancsmag alapértelmezés szerint lehetővé teszi a vendégügynök számára a bővítmények frissítését.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-EnableAutomaticUpgrade

Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.

Típus:Nullable<T>[Boolean]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ExtensionType

Megadja a bővítmény típusát.

Típus:String
Aliasok:Type
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ForceRerun

Azt jelzi, hogy ez a parancsmag ugyanazon bővítménykonfiguráció újrafuttatását kényszeríti a virtuális gépen a bővítmény eltávolítása és újratelepítése nélkül. Az érték bármilyen sztring lehet, amely eltér az aktuális értéktől. Ha a forceUpdateTag nem módosul, a kezelő továbbra is alkalmazza a nyilvános vagy védett beállítások frissítéseit.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Location

Megadja a virtuális gép helyét.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

A bővítmény nevét adja meg.

Típus:String
Aliasok:ExtensionName
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-NoWait

Elindítja a műveletet, és azonnal visszatér, mielőtt a művelet befejeződik. Annak megállapításához, hogy a művelet sikeresen befejeződött-e, használjon más mechanizmust.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ProtectedSettings

A bővítmény privát konfigurációját adja meg kivonattáblaként. Ez a parancsmag titkosítja a privát konfigurációt.

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ProtectedSettingString

Sztringként adja meg a bővítmény privát konfigurációját. Ez a parancsmag titkosítja a privát konfigurációt.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Publisher

Megadja a bővítmény közzétevőjének nevét. A közzétevő akkor ad nevet, ha a közzétevő regisztrál egy bővítményt.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Megadja a virtuális gép erőforráscsoportjának nevét.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Settings

A bővítmény nyilvános konfigurációját adja meg kivonattáblaként. Ez a parancsmag nem titkosítja a nyilvános konfigurációt.

Típus:Hashtable
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-SettingString

A bővítmény nyilvános konfigurációját adja meg sztringként. Ez a parancsmag nem titkosítja a nyilvános konfigurációt.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-TypeHandlerVersion

A virtuális géphez használandó bővítmény verzióját adja meg.

Típus:String
Aliasok:HandlerVersion, Version
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-VMName

A virtuális gép nevét adja meg. Ez a parancsmag módosítja a paraméter által megadott virtuális gép bővítményeit.

Típus:String
Aliasok:ResourceName
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

Hashtable

SwitchParameter

Kimenetek

PSAzureOperationResponse