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

Update-AzureApplicationGateway

更新应用程序网关。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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 分配给应用程序网关的说明。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-GatewaySize

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

  • 小型
  • 中型
  • 大型
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-InstanceCount

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

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Name

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Subnets

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

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

类型:List<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VnetName

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

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

String

输出

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse