Set-AzVMExtension
Uppdateringar tilläggsegenskaper eller lägger till ett tillägg till en virtuell dator.
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
Cmdleten Set-AzVMExtension uppdaterar egenskaper för befintliga tillägg för virtuella datorer eller lägger till ett tillägg till en virtuell dator.
Exempel
Exempel 1: Ändra inställningar med hjälp av hash-tabeller
$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 första två kommandona använder Windows PowerShell-standardsyntax för att skapa hash-tabeller och lagrar sedan dessa hash-tabeller i variablerna $Inställningar och $Protected Inställningar.
Om du vill ha mer information skriver du Get-Help about_Hash_Tables
.
Det andra kommandot innehåller två värden som tidigare skapats och lagrats i variabler.
Det sista kommandot ändrar ett tillägg för den virtuella datorn med namnet VirtualMachine22 i ResourceGroup11 enligt innehållet i $Inställningar och $Protected Inställningar.
Kommandot anger annan nödvändig information som innehåller utgivaren och tilläggstypen.
Exempel 2: Ändra inställningar med hjälp av strängar
$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 ;
De första två kommandona skapar strängar som innehåller inställningar och lagrar dem sedan i variablerna $Inställningar String och $Protected Inställningar String. Det sista kommandot ändrar ett tillägg för den virtuella datorn med namnet VirtualMachine22 i ResourceGroup11 enligt innehållet i $Inställningar String och $Protected Inställningar String. Kommandot anger annan nödvändig information som innehåller utgivaren och tilläggstypen.
Parametrar
-AsJob
Kör cmdlet i bakgrunden
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutoUpgradeMinorVersion
Anger att den här cmdleten hindrar Azure-gästagenten från att automatiskt uppdatera tilläggen till en nyare delversion. Som standard gör den här cmdleten det möjligt för gästagenten att uppdatera tilläggen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableAutomaticUpgrade
Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget tillgängligt.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionType
Anger tilläggstypen.
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ForceRerun
Anger att denna cmdlet tvingar fram en omkörning av samma tilläggskonfiguration på den virtuella datorn utan att avinstallera och installera om tillägget. Värdet kan vara valfri sträng som skiljer sig från det aktuella värdet. Om forceUpdateTag inte ändras tillämpas uppdateringar av offentliga eller skyddade inställningar fortfarande av hanteraren.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Anger platsen för den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger namnet på ett tillägg.
Type: | String |
Aliases: | ExtensionName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoWait
Startar åtgärden och returnerar omedelbart innan åtgärden har slutförts. Använd någon annan mekanism för att avgöra om åtgärden har slutförts.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProtectedSettings
Anger privat konfiguration för tillägget, som en hash-tabell. Den här cmdleten krypterar den privata konfigurationen.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProtectedSettingString
Anger privat konfiguration för tillägget som en sträng. Den här cmdleten krypterar den privata konfigurationen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Publisher
Anger namnet på tilläggsutgivaren. Utgivaren ger ett namn när utgivaren registrerar ett tillägg.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Anger namnet på resursgruppen för den virtuella datorn.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Settings
Anger offentlig konfiguration för tillägget, som en hash-tabell. Den här cmdleten krypterar inte offentlig konfiguration.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SettingString
Anger offentlig konfiguration för tillägget som en sträng. Den här cmdleten krypterar inte offentlig konfiguration.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TypeHandlerVersion
Anger vilken version av tillägget som ska användas för den här virtuella datorn.
Type: | String |
Aliases: | HandlerVersion, Version |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Anger namnet på en virtuell dator. Den här cmdleten ändrar tillägg för den virtuella dator som den här parametern anger.
Type: | String |
Aliases: | ResourceName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Utdata
Relaterade länkar
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för