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.
Syntaxis
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 |
| 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 |