Update-AzureApplicationGateway
更新应用程序网关。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Default （默认值）
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 "VirtualNetwork18" -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 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-GatewaySize
指定此 cmdlet 分配给应用程序网关的大小。 有效值为：
- 小型
- 中型
- 大型
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-InstanceCount
指定此 cmdlet 分配给应用程序网关的实例数。
参数属性
| 类型: | UInt32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
指定此 cmdlet 更新的应用程序网关的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
参数属性
| 类型: | AzureSMProfile |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Subnets
指定此 cmdlet 在其中部署应用程序网关的子网数组。
应用程序网关运行时无法更新子网。 若要停止应用程序网关，请使用 Stop-AzureApplicationGateway cmdlet。
参数属性
| 类型: | |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-VnetName
指定此 cmdlet 在其中部署应用程序网关的虚拟网络。
应用程序网关运行时无法更新虚拟网络。 若要停止应用程序网关，请使用 Stop-AzureApplicationGateway。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。