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

Set-AzApplicationGatewayFrontendIPConfig

  • 参考
模块:
Az.Network

修改前端 IP 地址配置。

语法

Set-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-PrivateLinkConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Set-AzApplicationGatewayFrontendIPConfig cmdlet 更新前端 IP 配置。 应用程序网关支持两种类型的前端 IP 地址：

  • 公共 IP 地址
  • 配置使用内部负载均衡（ILB）的专用 IP 地址：应用程序网关最多可以有一个公共 IP 地址和一个专用 IP 地址。 公共 IP 地址和专用 IP 地址应单独添加为前端 IP 地址。

示例

示例 1：将公共 IP 设置为应用程序网关的前端 IP

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

第一个命令创建公共 IP 地址对象并将其存储在$PublicIp变量中。 第二个命令获取名为 ApplicationGateway01 的应用程序网关，该网关属于名为 ResourceGroup01 的资源组，并将其存储在$AppGw变量中。 第三个命令使用存储在 $AppGw$PublicIp中的地址为网关更新名为 FrontEndIp01 的前端 IP 配置。

示例 2：将静态专用 IP 设置为应用程序网关的前端 IP

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

第一个命令获取一个名为 VNet01 的虚拟网络，该虚拟网络属于名为 ResourceGroup01 的资源组，并将其存储在$VNet变量中。 第二个命令使用第一个命令中的$VNet获取名为 Subnet01 的子网配置，并将其存储在$Subnet变量中。 第三个命令获取名为 ApplicationGateway01 的应用程序网关，该网关属于名为 ResourceGroup01 的资源组，并将其存储在$AppGw变量中。 第四个命令使用第二个命令中的$Subnet添加名为 FrontendIP02 的前端 IP 配置。

参数

-ApplicationGateway

指定要在其中修改前端 IP 配置的应用程序网关对象。

Type:PSApplicationGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定此 cmdlet 修改的前端 IP 配置的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIPAddress

指定专用 IP 地址。 如果指定，则从子网静态分配此 IP。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

Type:PSApplicationGatewayPrivateLinkConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddress

指定公共 IP 地址。

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddressId

指定公共 IP 地址的 ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

指定应用程序网关使用的子网。 如果网关使用专用 IP 地址，请指定此参数。 如果指定了 PrivateIPAddress 地址，则它应属于此子网。 如果未 指定 PrivateIPAddress ，则会动态选取此子网中的某个 IP 地址作为应用程序网关的前端 IP 地址。

Type:PSSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

指定子网 ID。 如果网关使用专用 IP 地址，请指定此参数。 如果指定了 PrivateIPAddress 参数，它应属于此子网。 如果未 指定 PrivateIPAddress ，则会动态选取此子网中的某个 IP 地址作为应用程序网关的前端 IP 地址。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSApplicationGateway

输出

PSApplicationGateway