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

Add-AzApplicationGatewayFrontendIPConfig

将前端 IP 配置添加到应用程序网关。

语法

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

说明

Add-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 = Add-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 = Add-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 = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

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

参数

-ApplicationGateway

指定此 cmdlet 向其添加前端 IP 配置的应用程序网关。

类型:PSApplicationGateway
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定要添加的前端 IP 配置的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-PrivateIPAddress

指定要作为应用程序网关的前端 IP 添加的专用 IP 地址。 如果指定,则从子网静态分配此 IP。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

类型:PSApplicationGatewayPrivateLinkConfiguration
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PublicIPAddress

指定此 cmdlet 添加的公共 IP 地址作为应用程序网关的前端 IP 地址。

类型:PSPublicIpAddress
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PublicIPAddressId

指定此 cmdlet 作为应用程序网关的前端 IP 地址添加的公共 IP 地址的 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Subnet

指定此 cmdlet 添加为前端 IP 配置的子网。 如果指定此参数,则表示应用程序网关支持基于 IP 的专用配置。 如果指定了 PrivateIPAddress 参数,它应属于此子网。 如果未 指定 PrivateIPAddress ,则会动态选取此子网中的某个 IP 地址作为应用程序网关的前端 IP 地址。

类型:PSSubnet
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubnetId

指定此 cmdlet 作为前端 IP 配置添加的子网 ID。 传递子网意味着专用 IP。 如果指定了 PrivateIPAddress 参数,它应属于此子网。 否则,此子网中的某个 IP 会作为应用程序网关的前端 IP 动态选取。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSApplicationGateway

输出

PSApplicationGateway