Set-AzVMExtension

  • Referentie
Module:
Az.Compute

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

Syntax

Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-Settings <Hashtable>]
   [-ProtectedSettings <Hashtable>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMExtension
   -Publisher <String>
   -ExtensionType <String>
   [-SettingString <String>]
   [-ProtectedSettingString <String>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-AsJob]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-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

$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -ExtensionType "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

$SettingsString = '{"fileUris":[],"commandToExecute":""}';
$ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -ExtensionType "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:AzContext, 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

-EnableAutomaticUpgrade

Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

Start de bewerking en retourneert onmiddellijk voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

Invoerwaarden

String

Hashtable

SwitchParameter

Uitvoerwaarden

PSAzureOperationResponse