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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-GatewaySize

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

  • Klein
  • Mittel
  • Groß
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceCount

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

Ausgaben

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse