通过

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

Update-AzureApplicationGateway

  • 参考
模块:
Azure

更新应用程序网关。

注意

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

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 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 分配给应用程序网关的说明。

类型: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