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

Add-AzLoadBalancerFrontendIpConfig

将前端 IP 配置添加到负载均衡器。

语法

Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-PrivateIpAddress <String>]
   [-PrivateIpAddressVersion <String>]
   [-Zone <String[]>]
   -Subnet <PSSubnet>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-PrivateIpAddress <String>]
   [-PrivateIpAddressVersion <String>]
   [-Zone <String[]>]
   -SubnetId <String>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Zone <String[]>]
   -PublicIpAddressId <String>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Zone <String[]>]
   -PublicIpAddress <PSPublicIpAddress>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Zone <String[]>]
   -PublicIpAddressPrefixId <String>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzLoadBalancerFrontendIpConfig
   -LoadBalancer <PSLoadBalancer>
   -Name <String>
   [-Zone <String[]>]
   -PublicIpAddressPrefix <PSPublicIpPrefix>
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Add-AzLoadBalancerFrontendIpConfig cmdlet 将前端 IP 配置添加到 Azure 负载均衡器。

示例

示例 1 添加具有动态 IP 地址的前端 IP 配置

$Subnet = Get-AzVirtualNetwork -Name "MyVnet" -ResourceGroupName "MyRg" | Get-AzVirtualNetworkSubnetConfig -Name "MySubnet"
Get-AzLoadBalancer -Name "MyLB" -ResourceGroupName "NrpTest" | Add-AzLoadBalancerFrontendIpConfig -Name "FrontendName" -Subnet $Subnet | Set-AzLoadBalancer

第一个命令获取名为 MyVnet 的 Azure 虚拟网络,并使用管道将结果传递给 Get-AzVirtualNetworkSubnetConfig cmdlet,以获取名为 MySubnet 的子网。 然后,该命令将结果存储在名为$Subnet的变量中。 第二个命令获取名为 MyLB 的负载均衡器,并将结果 传递给 Add-AzLoadBalancerFrontendIpConfig cmdlet,该 cmdlet 会将前端 IP 配置添加到负载均衡器,该负载均衡器具有存储在名为 $MySubnet 变量中的子网的动态专用 IP 地址。

示例 2 添加具有静态 IP 地址的前端 IP 配置

$Subnet = Get-AzVirtualNetwork -Name "MyVnet" -ResourceGroupName "RG001" | Get-AzVirtualNetworkSubnetConfig -Name "MySubnet"
Get-AzLoadBalancer -Name "MyLB" -ResourceGroupName "NrpTest" | Add-AzLoadBalancerFrontendIpConfig -Name "FrontendName" -Subnet $Subnet -PrivateIpAddress "10.0.1.6" | Set-AzLoadBalancer

第一个命令获取名为 MyVnet 的 Azure 虚拟网络,并使用管道将结果传递给 Get-AzVirtualNetworkSubnetConfig cmdlet,以获取名为 MySubnet 的子网。 然后,该命令将结果存储在名为$Subnet的变量中。 第二个命令获取名为 MyLB 的负载均衡器,并将结果 传递给 Add-AzLoadBalancerFrontendIpConfig cmdlet,该 cmdlet 会将前端 IP 配置添加到负载均衡器,该负载均衡器具有存储在名为 $Subnet 变量中的子网的静态专用 IP 地址。

示例 3 添加具有公共 IP 地址的前端 IP 配置

$PublicIp = Get-AzPublicIpAddress -ResourceGroupName "myRG" -Name "MyPub"
Get-AzLoadBalancer -Name "MyLB" -ResourceGroupName "NrpTest" | Add-AzLoadBalancerFrontendIpConfig -Name "FrontendName" -PublicIpAddress $PublicIp | Set-AzLoadBalancer

第一个命令获取名为 MyPub 的 Azure 公共 IP 地址,并将结果存储在名为 $PublicIp 的变量中。 第二个命令获取名为 MyLB 的负载均衡器,并将结果 传递给 Add-AzLoadBalancerFrontendIpConfig cmdlet,该 cmdlet 会将前端 IP 配置添加到负载均衡器,该负载均衡器具有存储在名为 $PublicIp 变量中的公共 IP 地址。

示例 4 添加具有公共 IP 前缀的前端 IP 配置

$PublicIpPrefix = Get-AzPublicIpPrefix -ResourceGroupName "myRG" -Name "MyPubPrefix"
Get-AzLoadBalancer -Name "MyLB" -ResourceGroupName "NrpTest" | Add-AzLoadBalancerFrontendIpConfig -Name "FrontendName" -PublicIpAddressPrefix $PublicIpPrefix | Set-AzLoadBalancer

第一个命令获取名为 MyPubPrefix 的 Azure 公共 IP 前缀,并将结果存储在名为$PublicIpPrefix的变量中。 第二个命令获取名为 MyLB 的负载均衡器,并将结果 传递给 Add-AzLoadBalancerFrontendIpConfig cmdlet,该 cmdlet 会将前端 IP 配置添加到名为$PublicIpPrefix的变量中存储的公共 IP 前缀的负载均衡器。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-GatewayLoadBalancerId

网关 LoadBalancer 提供程序资源的引用。

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

-LoadBalancer

指定 LoadBalancer 对象。 此 cmdlet 将前端 IP 配置添加到此参数指定的负载均衡器。

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

-Name

指定要添加的前端 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:True
Accept wildcard characters:False

-PrivateIpAddressVersion

IP 配置的专用 IP 地址版本。

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpAddress

指定要与前端 IP 配置关联的公共 IP 地址。

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

-PublicIpAddressId

指定要在其中添加前端 IP 配置的公共 IP 地址的 ID。

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

-PublicIpAddressPrefix

指定要与前端 IP 配置关联的公共 IP 地址前缀对象。

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

-PublicIpAddressPrefixId

指定要与前端 IP 配置关联的公共 IP 地址前缀对象的 ID。

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

-Subnet

指定要在其中添加前端 IP 配置的子网对象。

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

-SubnetId

指定要在其中添加前端 IP 配置的子网的 ID。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

表示为资源分配的 IP 需要来自的可用性区域列表。

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

输入

PSLoadBalancer

String

String[]

PSSubnet

PSPublicIpAddress

输出

PSLoadBalancer