Set-AzureRmVMExtension

Reference

Modul:: AzureRM.Compute

Aktualizace vlastnosti rozšíření nebo přidá rozšíření do virtuálního počítače.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

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

Rutina Set-AzureRmVMExtension aktualizuje vlastnosti pro existující rozšíření virtuálních počítačů nebo přidá rozšíření do virtuálního počítače.

Příklady

Příklad 1: Úprava nastavení pomocí tabulek hash

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;

První dva příkazy používají standardní syntaxi Windows PowerShellu k vytvoření tabulek hash a pak tyto hashovací tabulky uloží do proměnných $Nastavení a $Protected Nastavení. Další informace potřebujete zadáním Get-Help about_Hash_Tables. Druhý příkaz obsahuje dvě hodnoty, které byly dříve vytvořeny a uloženy v proměnných. Poslední příkaz upraví rozšíření virtuálního počítače s názvem VirtualMachine22 v ResourceGroup11 podle obsahu $Nastavení a $Protected Nastavení. Příkaz určuje další požadované informace, které zahrnují vydavatele a typ rozšíření.

Příklad 2: Úprava nastavení pomocí řetězců

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 ;

První dva příkazy vytvoří řetězce, které obsahují nastavení, a pak je uloží do proměnných $Nastavení String a $Protected Nastavení String. Poslední příkaz upraví rozšíření virtuálního počítače s názvem VirtualMachine22 v ResourceGroup11 podle obsahu $Nastavení String a $Protected Nastavení String. Příkaz určuje další požadované informace, které zahrnují vydavatele a typ rozšíření.

Parametry

-AsJob

Spuštění rutiny na pozadí

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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í.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExtensionType

Určuje typ rozšíření.

Type:	String
Aliases:	Type
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

Označuje, že tato rutina vynutí opětovné spuštění stejné konfigurace rozšíření na virtuálním počítači bez odinstalace a přeinstalace rozšíření. 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Určuje umístění virtuálního počítače.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	ExtensionName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProtectedSettings

Určuje privátní konfiguraci rozšíření jako tabulku hash. Tato rutina šifruje privátní konfiguraci.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProtectedSettingString

Určuje privátní konfiguraci rozšíření jako řetězec. Tato rutina šifruje privátní konfiguraci.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Publisher

Určuje název vydavatele rozšíření. Vydavatel zadá název, když vydavatel zaregistruje rozšíření.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Určuje název skupiny prostředků virtuálního počítače.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Settings

Určuje veřejnou konfiguraci rozšíření jako tabulku hash. Tato rutina nešifruje veřejnou konfiguraci.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SettingString

Určuje veřejnou konfiguraci rozšíření jako řetězec. Tato rutina nešifruje veřejnou konfiguraci.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TypeHandlerVersion

Určuje verzi rozšíření, která se má použít pro tento virtuální počítač.

Type:	String
Aliases:	HandlerVersion, Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Určuje název virtuálního počítače. Tato rutina upraví rozšíření pro virtuální počítač, který tento parametr určuje.

Type:	String
Aliases:	ResourceName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

String

Hashtable

SwitchParameter

Výstupy

PSAzureOperationResponse