你当前正在访问 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 |
输入
输出
Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse