你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-AzureApplicationGateway

更新应用程序网关。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块

语法

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

说明

Update-AzureApplicationGateway cmdlet 更新现有应用程序网关。

示例

示例 1:使用应用程序网关的名称修改应用程序网关

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

第一个命令停止名为 ApplicationGateway06 的应用程序网关。 必须先停止应用程序网关,然后才能修改虚拟网络或子网。

第二个命令修改名为 ApplicationGateway06 的应用程序网关的虚拟子网和子网。

示例 2:修改应用程序网关的其他属性

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

此命令修改名为 ApplicationGateway06 的应用程序网关的实例计数、网关大小和说明。 此命令不会修改应用程序网关的虚拟网络或子网。 因此,在运行此命令之前,无需停止应用程序网关。

示例 3:使用管道修改应用程序网关

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

第一个命令使用 Get-AzureApplicationGateway cmdlet 获取名为 ApplicationGateway06 的应用程序网关。 该命令将其存储在$ApplicationGateway变量中。

第二个命令为 GatewaySize 属性分配值 Medium。

最后一个命令将更新的$ApplicationGateway传递到当前 cmdlet。

参数

-Description

指定此 cmdlet 分配给应用程序网关的说明。

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

-GatewaySize

指定此 cmdlet 分配给应用程序网关的大小。 有效值是:

  • 小型
  • 中等
  • 大型
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceCount

指定此 cmdlet 分配给应用程序网关的实例数。

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

-Name

指定此 cmdlet 更新的应用程序网关的名称。

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

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

-Subnets

指定此 cmdlet 在其中部署应用程序网关的子网数组。

应用程序网关运行时无法更新子网。 若要停止应用程序网关,请使用 Stop-AzureApplicationGateway cmdlet。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VnetName

指定此 cmdlet 在其中部署应用程序网关的虚拟网络。

应用程序网关运行时无法更新虚拟网络。 若要停止应用程序网关,请使用 Stop-AzureApplicationGateway

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

输入

String

输出

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse