Set-AzureRmVMExtension
Frissítések bővítménytulajdonságokat, vagy bővítményt ad hozzá egy virtuális géphez.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Syntax
Set-AzureRmVMExtension
-Publisher <String>
-ExtensionType <String>
[-Settings <Hashtable>]
[-ProtectedSettings <Hashtable>]
[-AsJob]
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmVMExtension
-Publisher <String>
-ExtensionType <String>
[-SettingString <String>]
[-ProtectedSettingString <String>]
[-AsJob]
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
A Set-AzureRmVMExtension 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
PS C:\> $Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
PS C:\> $ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
PS C:\> Set-AzureRmVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -Type "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 $Gépház és $Protected Gépház 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 $Gépház és a $Protected Gépház 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
PS C:\> $SettingsString = '{"fileUris":[],"commandToExecute":""}';
PS C:\> $ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
PS C:\> Set-AzureRmVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -Type "CustomScriptExtension" -TypeHandlerVersion "1.1" -SettingString $SettingsString -ProtectedSettingString $ProtectedSettingsString ;Az első két parancs beállításokat tartalmazó sztringeket hoz létre, majd a $Gépház String és $Protected Gépház String 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 $Gépház String és $Protected Gépház String 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: | 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 |
-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ő: | False |
| Folyamatbemenet elfogadása: | True |
| 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 |