Set-AzureRmVMExtension
Werkt extensie-eigenschappen bij of voegt een extensie toe aan een virtuele machine.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
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
De cmdlet Set-AzureRmVMExtension 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-AzureRmVMExtension -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 om hashtabellen te maken en slaat deze hashtabellen vervolgens op in de variabelen $Instellingen en $Protected Instellingen.
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 $Instellingen en $Protected Instellingen.
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-AzureRmVMExtension -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 variabelen $Instellingen String en $Protected Instellingen String. Met de laatste opdracht wijzigt u een uitbreiding van de virtuele machine met de naam VirtualMachine22 in ResourceGroup11 op basis van de inhoud van $Instellingen String en $Protected Instellingen String. 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionType
Hiermee geeft u het extensietype.
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Hiermee geeft u de locatie van de virtuele machine.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam van een extensie.
Type: | String |
Aliases: | ExtensionName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep van de virtuele machine.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TypeHandlerVersion
Hiermee geeft u de versie van de extensie te gebruiken voor deze virtuele machine.
Type: | String |
Aliases: | HandlerVersion, Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | ResourceName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |