Update-​Azure​Application​Gateway

Updates an application gateway.

Syntax

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

Description

The Update-AzureApplicationGateway cmdlet updates an existing application gateway.

Examples

Example 1: Modify an application gateway by using its name

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

The first command stops the application gateway named ApplicationGateway06. An application gateway must be stopped before you can modify the virtual network or subnets.

The second command modifies the virtual subnet and subnets for the application gateway named ApplicationGateway06.

Example 2: Modify additional properties of an application gateway

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

This command modifies the instance count, gateway size, and description for the application gateway named ApplicationGateway06. This command does not modify the virtual network or subnets for the application gateway. Therefore, you do not have to stop the application gateway before you run this command.

Example 3: Modify an application gateway by using the pipeline

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

The first command gets the application gateway named ApplicationGateway06 by using the Get-AzureApplicationGateway cmdlet. The command stores it in the $ApplicationGateway variable.

The second command assigns the GatewaySize property the value Medium.

The final command passes the updated $ApplicationGateway to the current cmdlet.

Required Parameters

-Name

Specifies the name of the application gateway that this cmdlet updates.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-Description

Specifies a description that this cmdlet assigns to the application gateway.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-GatewaySize

Specifies the size that this cmdlet assigns to the application gateway. Valid values are:

  • Small
  • Medium
  • Large
Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-InstanceCount

Specifies the number of instances that this cmdlet assigns to the application gateway.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Type:AzureSMProfile
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Subnets

Specifies an array of subnets in which this cmdlet deploys the application gateway.

You cannot update subnets while the application gateway is running. To stop the application gateway, use the Stop-AzureApplicationGateway cmdlet.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-VnetName

Specifies the virtual network in which this cmdlet deploys the application gateway.

You cannot update a virtual network while the application gateway is running. To stop the application gateway, use Stop-AzureApplicationGateway.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

System.String

Outputs

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse