你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRmApplicationGatewayFrontendIPConfig
修改前端 IP 地址配置。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
Set-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Set-AzureRmApplicationGatewayFrontendIPConfig cmdlet 更新前端 IP 配置。 应用程序网关支持两种类型的前端 IP 地址：
- 公共 IP 地址
- 配置使用内部负载均衡（ILB）的专用 IP 地址：应用程序网关最多可以有一个公共 IP 地址和一个专用 IP 地址。 公共 IP 地址和专用 IP 地址应单独添加为前端 IP 地址。
示例
示例 1：将公共 IP 设置为应用程序网关的前端 IP
PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp第一个命令创建公共 IP 地址对象并将其存储在$PublicIp变量中。 第二个命令获取名为 ApplicationGateway01 的应用程序网关，该网关属于名为 ResourceGroup01 的资源组，并将其存储在$AppGw变量中。 第三个命令使用存储在 $AppGw$PublicIp中的地址为网关更新名为 FrontEndIp01 的前端 IP 配置。
示例 2：将静态专用 IP 设置为应用程序网关的前端 IP
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1第一个命令获取一个名为 VNet01 的虚拟网络，该虚拟网络属于名为 ResourceGroup01 的资源组，并将其存储在$VNet变量中。 第二个命令使用第一个命令中的$VNet获取名为 Subnet01 的子网配置，并将其存储在$Subnet变量中。 第三个命令获取名为 ApplicationGateway01 的应用程序网关，该网关属于名为 ResourceGroup01 的资源组，并将其存储在$AppGw变量中。 第四个命令使用第二个命令中的$Subnet和专用 IP 地址 10.0.1.1 添加名为 FrontendIP02 的前端 IP 配置。
示例 3：将动态专用 IP 设置为应用程序网关的前端 IP
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet第一个命令获取一个名为 VNet01 的虚拟网络，该虚拟网络属于名为 ResourceGroup01 的资源组，并将其存储在$VNet变量中。 第二个命令使用第一个命令中的$VNet获取名为 Subnet01 的子网配置，并将其存储在$Subnet变量中。 第三个命令获取名为 ApplicationGateway01 的应用程序网关，该网关属于名为 ResourceGroup01 的资源组，并将其存储在$AppGw变量中。 第四个命令使用第二个命令中的$Subnet添加名为 FrontendIP02 的前端 IP 配置。
参数
-ApplicationGateway
指定要在其中修改前端 IP 配置的应用程序网关对象。
| 类型: | PSApplicationGateway |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定此 cmdlet 修改的前端 IP 配置的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrivateIPAddress
指定专用 IP 地址。 如果指定，则从子网静态分配此 IP。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicIPAddress
指定公共 IP 地址。
| 类型: | PSPublicIpAddress |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicIPAddressId
指定公共 IP 地址的 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Subnet
指定应用程序网关使用的子网。 如果网关使用专用 IP 地址，请指定此参数。 如果指定了 PrivateIPAddress 地址，则它应属于此子网。 如果未 指定 PrivateIPAddress ，则会动态选取此子网中的某个 IP 地址作为应用程序网关的前端 IP 地址。
| 类型: | PSSubnet |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SubnetId
指定子网 ID。 如果网关使用专用 IP 地址，请指定此参数。 如果指定了 PrivateIPAddress 参数，它应属于此子网。 如果未 指定 PrivateIPAddress ，则会动态选取此子网中的某个 IP 地址作为应用程序网关的前端 IP 地址。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
参数：ApplicationGateway （ByValue）