Delen via


Set-AzVMExtension

Werkt extensie-eigenschappen bij of voegt een extensie toe aan een virtuele machine.

Syntaxis

Set-AzVMExtension
   -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-AzVMExtension
   -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

De cmdlet Set-AzVMExtension werkt eigenschappen bij voor bestaande extensies voor virtuele machines of voegt een extensie toe aan een virtuele machine.

Voorbeelden

Voorbeeld 1: Instellingen wijzigen met behulp van hashtabellen

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

De eerste twee opdrachten maken gebruik van de standaard Windows PowerShell-syntaxis voor het maken van hash-tabellen en slaat deze hashtabellen vervolgens op in de $Settings en $ProtectedSettings variabelen. Typ voor meer informatie Get-Help about_Hash_Tables. De tweede opdracht bevat twee waarden die eerder zijn gemaakt en opgeslagen in variabelen.

Met de laatste opdracht wijzigt u een uitbreiding van de virtuele machine met de naam VirtualMachine22 in ResourceGroup11 op basis van de inhoud van $Settings en $ProtectedSettings. Met de opdracht geeft u andere vereiste informatie op die de uitgever en het extensietype bevat.

Voorbeeld 2: Instellingen wijzigen met tekenreeksen

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

Met de eerste twee opdrachten worden tekenreeksen gemaakt die instellingen bevatten en worden deze vervolgens opgeslagen in de $SettingsString en $ProtectedSettingsString variabelen.

Met de laatste opdracht wijzigt u een uitbreiding van de virtuele machine met de naam VirtualMachine22 in ResourceGroup11 op basis van de inhoud van $SettingsString en $ProtectedSettingsString. Met de opdracht geeft u andere vereiste informatie op die de uitgever en het extensietype bevat.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableAutoUpgradeMinorVersion

Geeft aan dat deze cmdlet voorkomt dat de Azure-gastagent de extensies automatisch bijwerkt naar een nieuwere secundaire versie. Met deze cmdlet kan de gastagent de extensies standaard bijwerken.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExtensionType

Hiermee geeft u het extensietype.

Type:String
Aliassen:Type
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ForceRerun

Geeft aan dat met deze cmdlet dezelfde extensieconfiguratie op de virtuele machine opnieuw wordt uitgevoerd zonder de extensie te verwijderen en opnieuw te installeren. De waarde kan elke tekenreeks zijn die verschilt van de huidige waarde.

Als forceUpdateTag niet wordt gewijzigd, worden updates voor openbare of beveiligde instellingen nog steeds toegepast door de handler.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een extensie.

Type:String
Aliassen:ExtensionName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ProtectedSettings

Hiermee geeft u de persoonlijke configuratie voor de extensie, als een hash-tabel. Met deze cmdlet wordt de persoonlijke configuratie versleuteld.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ProtectedSettingString

Hiermee geeft u de persoonlijke configuratie voor de extensie, als een tekenreeks. Met deze cmdlet wordt de persoonlijke configuratie versleuteld.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Publisher

Hiermee geeft u de naam van de extensie-uitgever. De uitgever geeft een naam op wanneer de uitgever een extensie registreert.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Settings

Hiermee geeft u openbare configuratie voor de extensie, als een hash-tabel. Met deze cmdlet wordt de openbare configuratie niet versleuteld.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SettingString

Hiermee geeft u openbare configuratie voor de extensie, als een tekenreeks. Met deze cmdlet wordt de openbare configuratie niet versleuteld.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TypeHandlerVersion

Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine.

Type:String
Aliassen:HandlerVersion, Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

Hiermee geeft u de naam van een virtuele machine. Met deze cmdlet worden extensies gewijzigd voor de virtuele machine die met deze parameter wordt opgegeven.

Type:String
Aliassen:ResourceName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert.

De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

PSAzureOperationResponse