你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Add-AzureRmApplicationGatewayFrontendIPConfig
将前端 IP 配置添加到应用程序网关。
警告
截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
Add-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Add-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 = Add-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 = Add-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 = Add-AzureRmApplicationGatewayFrontendIPConfig -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 |
别名: | 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 |
-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。 如果指定 PrivateIPAddresss 参数,它应属于此子网。 否则,此子网中的某个 IP 会作为应用程序网关的前端 IP 动态选取。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
参数:ApplicationGateway (ByValue)