通过

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

New-AzApplicationGatewayFrontendIPConfig

模块:
Az.Network Module

为应用程序网关创建前端 IP 配置。

语法

SetByResourceId 

New-AzApplicationGatewayFrontendIPConfig
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

New-AzApplicationGatewayFrontendIPConfig
    -Name <String>
    [-PrivateIPAddress <String>]
    [-Subnet <PSSubnet>]
    [-PublicIPAddress <PSPublicIpAddress>]
    [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

New-AzApplicationGatewayFrontendIPConfig cmdlet 为 Azure 应用程序网关创建前端 IP 配置。 应用程序网关支持两种类型的前端 IP 配置：

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

示例

示例 1：使用公共 IP 资源对象创建前端 IP 配置

$PublicIP = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP

第一个命令创建公共 IP 资源对象并将其存储在$PublicIP变量中。 第二个命令使用 $PublicIP 创建新的名为 FrontEndIP01 的前端 IP 配置，并将其存储在$FrontEnd变量中。

示例 2：创建静态专用 IP 作为前端 IP 地址

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

第一个命令获取一个名为 VNet01 的虚拟网络，该虚拟网络属于名为 ResourceGroup01 的资源组，并将其存储在$VNet变量中。 第二个命令使用第一个命令中的$VNet获取名为 Subnet01 的子网配置，并将其存储在$Subnet变量中。 第三个命令使用第二个命令和专用 IP 地址 10.0.1.1 中的$Subnet创建名为 FrontEndIP02 的前端 IP 配置，然后将其存储在$FrontEnd变量中。

示例 3：创建动态专用 IP 作为前端 IP 地址

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -Subnet $Subnet

第一个命令获取一个名为 VNet01 的虚拟网络，该虚拟网络属于名为 ResourceGroup01 的资源组，并将其存储在$VNet变量中。 第二个命令使用第一个命令中的$VNet获取名为 Subnet01 的子网配置，并将其存储在$Subnet变量中。 第三个命令使用第二个命令中的$Subnet创建名为 FrontEndIP03 的前端 IP 配置，并将其存储在$FrontEnd变量中。

参数

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

指定此 cmdlet 创建的前端 IP 配置的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PrivateIPAddress

指定此 cmdlet 与应用程序网关的前端 IP 地址关联的专用 IP 地址。 仅当指定子网时，才能指定此值。 此 IP 从子网静态分配。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

参数属性

类型:PSApplicationGatewayPrivateLinkConfiguration
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PublicIPAddress

指定此 cmdlet 与应用程序网关的前端 IP 地址关联的公共 IP 地址对象。

参数属性

类型:PSPublicIpAddress
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PublicIPAddressId

指定此 cmdlet 与应用程序网关的前端 IP 关联的公共 IP 地址 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Subnet

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

参数属性

类型:PSSubnet
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SubnetId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

None

输出

PSApplicationGatewayFrontendIPConfiguration