Freigeben über

Update-AzureApplicationGateway

  • Referenz
Modul:
Azure

Aktualisiert ein Anwendungsgateway.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Update-AzureApplicationGateway
      -Name <String>
      [-VnetName <String>]
      [-Subnets <System.Collections.Generic.List`1[System.String]>]
      [-InstanceCount <UInt32>]
      [-GatewaySize <String>]
      [-Description <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-AzureApplicationGateway aktualisiert ein vorhandenes Anwendungsgateway.

Beispiele

Beispiel 1: Ändern eines Anwendungsgateways mithilfe seines Namens

PS C:\> Stop-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -VnetName "VirutalNetwork18" -Subnets @("Subnet05", "Subnet06")

Der erste Befehl beendet das Anwendungsgateway mit dem Namen ApplicationGateway06. Ein Anwendungsgateway muss beendet werden, bevor Sie das virtuelle Netzwerk oder subnetze ändern können.

Der zweite Befehl ändert das virtuelle Subnetz und die Subnetze für das Anwendungsgateway06.

Beispiel 2: Ändern zusätzlicher Eigenschaften eines Anwendungsgateways

PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -InstanceCount 2 -GatewaySize "Large" -Description "Updated application gateway"

Mit diesem Befehl werden die Instanzenanzahl, die Gatewaygröße und die Beschreibung für das Anwendungsgateway mit dem Namen ApplicationGateway06 geändert. Mit diesem Befehl werden das virtuelle Netzwerk oder die Subnetze für das Anwendungsgateway nicht geändert. Daher müssen Sie das Anwendungsgateway nicht beenden, bevor Sie diesen Befehl ausführen.

Beispiel 3: Ändern eines Anwendungsgateways mithilfe der Pipeline

PS C:\> $ApplicationGateway = Get-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> $ApplicationGateway.GatewaySize = "Medium"
PS C:\> $ApplicationGateway | Update-AzureApplicationGateway

Der erste Befehl ruft das Anwendungsgateway06 mithilfe des Cmdlets "Get-AzureApplicationGateway " ab. Der Befehl speichert sie in der variablen $ApplicationGateway.

Der zweite Befehl weist der GatewaySize-Eigenschaft den Wert Medium zu.

Der letzte Befehl übergibt die aktualisierte $ApplicationGateway an das aktuelle Cmdlet.

Parameter

-Description

Gibt eine Beschreibung an, die dieses Cmdlet dem Anwendungsgateway zuweist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-GatewaySize

Gibt die Größe an, die dieses Cmdlet dem Anwendungsgateway zuweist. Gültige Werte sind:

  • Klein
  • Medium
  • Groß
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InstanceCount

Gibt die Anzahl der Instanzen an, die dieses Cmdlet dem Anwendungsgateway zuweist.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Anwendungsgateways an, das dieses Cmdlet aktualisiert.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Subnets

Gibt ein Array von Subnetzen an, in denen dieses Cmdlet das Anwendungsgateway bereitstellt.

Subnetze können nicht aktualisiert werden, während das Anwendungsgateway ausgeführt wird. Verwenden Sie das Cmdlet Stop-AzureApplicationGateway, um das Anwendungsgateway zu beenden.

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VnetName

Gibt das virtuelle Netzwerk an, in dem dieses Cmdlet das Anwendungsgateway bereitstellt.

Sie können ein virtuelles Netzwerk nicht aktualisieren, während das Anwendungsgateway ausgeführt wird. Verwenden Sie "Stop-AzureApplicationGateway", um das Anwendungsgateway zu beenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse