Dela via


Add-AzureRmVmssExtension

Lägger till ett tillägg till VMSS.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

Add-AzureRmVmssExtension
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-Name] <String>]
   [[-Publisher] <String>]
   [[-Type] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [[-Setting] <Object>]
   [[-ProtectedSetting] <Object>]
   [-ForceUpdateTag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Add-AzureRmVmssExtension lägger till ett tillägg till VMSS (Virtual Machine Scale Set).

Exempel

Exempel 1: Lägg till ett tillägg till VMSS

PS C:\> Add-AzureRmVmssExtension -VirtualMachineScaleSet $VMSS -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True

Det här kommandot lägger till ett tillägg till VMSS.

Exempel 2: Lägg till ett tillägg till VMSS med inställningar och skyddade inställningar

PS C:\> $Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
PS C:\> $ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};

PS C:\> Add-AzureRmVmssExtension -VirtualMachineScaleSet $vmss -Name $vmssExtensionName -Publisher $vmssPublisher  `
  -Type $vmssExtensionType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True  `
  -Setting $Settings -ProtectedSetting $ProtectedSettings

Det här kommandot lägger till ett tillägg till VMSS med ett bash-exempelskript på en bloblagring, anger URL:en för bloblagring och körbart kommando i inställningar och säkerhetsåtkomst i skyddade inställningar.

Parametrar

-AutoUpgradeMinorVersion

Anger om tilläggsversionen ska uppdateras automatiskt till en nyare delversion.

Typ:Nullable<T>[Boolean]
Position:5
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceUpdateTag

Om ett värde anges och skiljer sig från det tidigare värdet tvingas tilläggshanteraren att uppdatera även om tilläggskonfigurationen inte har ändrats.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnet på tillägget som den här cmdleten lägger till.

Typ:String
Position:1
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ProtectedSetting

Anger privat konfiguration för tillägget som en sträng. Den här cmdleten krypterar den privata konfigurationen.

Typ:Object
Position:7
standardvärde:None
Obligatorisk: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. Detta kan använda cmdleten Get-AzureRmVMImagePublisher för att hämta utgivaren.

Typ:String
Position:2
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Setting

Anger den offentliga konfigurationen, som en sträng, för tillägget. Den här cmdleten krypterar inte offentlig konfiguration.

Typ:Object
Position:6
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Type

Anger tilläggstypen. Du kan använda cmdleten Get-AzureRmVMExtensionImageType för att hämta tilläggstypen.

Typ:String
Position:3
standardvärde:None
Obligatorisk: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. Du kan använda cmdleten Get-AzureRmVMExtensionImage för att hämta versionen av tillägget.

Typ:String
Position:4
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-VirtualMachineScaleSet

Ange VMSS-objektet. Du kan använda New-AzureRmVmssConfig för att skapa objektet.

Typ:PSVirtualMachineScaleSet
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Object

Utdata

PSVirtualMachineScaleSet