Freigeben über

Add-AzureRmVmssExtension

  • Referenz
Modul:
AzureRM.Compute

Fügt der VMSS eine Erweiterung hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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>]

Beschreibung

Das Add-AzureRmVmssExtension-Cmdlet fügt eine Erweiterung zum Vm Scale Set (VMSS) hinzu.

Beispiele

Beispiel 1: Hinzufügen einer Erweiterung zum VMSS

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

Mit diesem Befehl wird der VMSS eine Erweiterung hinzugefügt.

Beispiel 2: Hinzufügen einer Erweiterung zu VMSS mit Einstellungen und geschützten Einstellungen

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

Mit diesem Befehl wird der VMSS eine Erweiterung mit einem Beispiel-Bash-Skript auf einem Blobspeicher hinzugefügt, die URL des Blobspeichers und des ausführbaren Befehls in Den Einstellungen und dem Sicherheitszugriff in geschützten Einstellungen angegeben.

Parameter

-AutoUpgradeMinorVersion

Gibt an, ob die Erweiterungsversion automatisch auf eine neuere Nebenversion aktualisiert werden soll.

Typ:Nullable<T>[Boolean]
Position:5
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceUpdateTag

Wenn ein Wert bereitgestellt wird und sich vom vorherigen Wert unterscheidet, wird der Erweiterungshandler gezwungen, zu aktualisieren, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen der Erweiterung an, die dieses Cmdlet hinzufügt.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-ProtectedSetting

Gibt die private Konfiguration für die Erweiterung als Zeichenfolge an. Dieses Cmdlet verschlüsselt die private Konfiguration.

Typ:Object
Position:7
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Publisher

Gibt den Namen des Erweiterungsherausgebers an. Der Herausgeber stellt einen Namen bereit, wenn der Herausgeber eine Erweiterung registriert. Dies kann das Cmdlet Get-AzureRmVMImagePublisher verwenden, um den Herausgeber abzurufen.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Setting

Gibt die öffentliche Konfiguration als Zeichenfolge für die Erweiterung an. Dieses Cmdlet verschlüsselt keine öffentliche Konfiguration.

Typ:Object
Position:6
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Type

Gibt den Erweiterungstyp an. Sie können das Cmdlet Get-AzureRmVMExtensionImageType verwenden, um den Erweiterungstyp abzurufen.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Gibt die Version der Erweiterung an, die für diesen virtuellen Computer verwendet werden soll. Sie können das Cmdlet Get-AzureRmVMExtensionImage verwenden, um die Version der Erweiterung abzurufen.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-VirtualMachineScaleSet

Geben Sie das VMSS-Objekt an. Sie können das Objekt mithilfe der New-AzureRmVmssConfig erstellen.

Typ:PSVirtualMachineScaleSet
Position:0
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSVirtualMachineScaleSet

String

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

Object

Ausgaben

PSVirtualMachineScaleSet