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

Set-AzLoadBalancerFrontendIpConfig

更新负载均衡器的前端 IP 配置。

语法

SetByResourceSubnet (默认值)

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -Subnet <PSSubnet>
    [-PrivateIpAddress <String>]
    [-PrivateIpAddressVersion <String>]
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdSubnet

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -SubnetId <String>
    [-PrivateIpAddress <String>]
    [-PrivateIpAddressVersion <String>]
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdPublicIpAddress

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -PublicIpAddressId <String>
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourcePublicIpAddress

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -PublicIpAddress <PSPublicIpAddress>
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdPublicIpAddressPrefix

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -PublicIpAddressPrefixId <String>
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourcePublicIpAddressPrefix

Set-AzLoadBalancerFrontendIpConfig
    -LoadBalancer <PSLoadBalancer>
    -Name <String>
    -PublicIpAddressPrefix <PSPublicIpPrefix>
    [-Zone <String[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzLoadBalancerFrontendIpConfig cmdlet 更新负载均衡器的前端 IP 配置。

示例

示例 1:修改负载均衡器的前端 IP 配置

$Subnet = Get-AzVirtualNetwork -Name "MyVnet" -ResourceGroupName "MyResourceGroup" | Get-AzVirtualNetworkSubnetConfig -Name "Subnet"
$slb = Get-AzLoadBalancer -Name "MyLoadBalancer" -ResourceGroupName "MyResourceGroup"
$slb | Add-AzLoadBalancerFrontendIpConfig -Name "NewFrontend" -Subnet $Subnet
$slb | Set-AzLoadBalancerFrontendIpConfig -Name "NewFrontend" -Subnet $Subnet
$slb | Set-AzLoadBalancer

第一个命令获取名为 Subnet 的虚拟子网,然后将其存储在$Subnet变量中。 第二个命令获取名为 MyLoadBalancer 的关联负载均衡器,然后将其存储在$slb变量中。 第三个命令使用管道运算符将$slb中的负载均衡器传递给 Add-AzLoadBalancerFrontendIpConfig,该配置为 $slb 创建名为 NewFrontend 的前端 IP 配置。 第四个命令将$slb中的负载均衡器传递到 Set-AzLoadBalancerFrontendIpConfig,后者保存和更新前端 IP 配置。

示例 2:使用网关负载均衡器修改负载均衡器的前端 IP 配置

$slb1 = Get-AzLoadBalancer -Name "MyLoadBalancer1" -ResourceGroupName "MyResourceGroup"
$feip = Get-AzLoadBalancerFrontendIpConfig -Name "MyFrontEnd" -LoadBalancer $slb1
$slb2 = Get-AzLoadBalancer -Name "MyLoadBalancer1" -ResourceGroupName "MyResourceGroup"
$slb2 | Set-AzLoadBalancerFrontendIpConfig -Name "NewFrontend" -PublicIpAddress $publicIp -GatewayLoadBalancerId $feip.Id
$slb2 | Set-AzLoadBalancer

参数

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

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

-DefaultProfile

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

参数属性

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

参数集

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

-GatewayLoadBalancerId

指定网关负载均衡器提供程序前端 Ip 配置的 ID。

参数属性

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

参数集

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

-LoadBalancer

指定负载均衡器。 此 cmdlet 更新此参数指定的负载均衡器的前端配置。

参数属性

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

参数集

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

-Name

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

参数属性

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

参数集

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

-PrivateIpAddress

指定要设置的前端 IP 配置关联的负载均衡器的专用 IP 地址。 仅当同时指定 Subnet 参数时,才指定此参数。

参数属性

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

参数集

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

-PrivateIpAddressVersion

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

参数属性

类型:String
默认值:None
接受的值:IPv4, IPv6
支持通配符:False
不显示:False

参数集

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

-PublicIpAddress

指定要设置的前端 IP 配置关联的 PublicIpAddress 对象。

参数属性

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

参数集

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

-PublicIpAddressId

指定与此 cmdlet 设置的前端 IP 配置关联的 PublicIpAddress 对象的 ID。

参数属性

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

参数集

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

-PublicIpAddressPrefix

指定要与前端 IP 配置关联的 PublicIpAddressPrefix 对象。

参数属性

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

参数集

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

-PublicIpAddressPrefixId

指定要与前端 IP 配置关联的 PublicIpAddressPrefix 对象的 ID。

参数属性

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

参数集

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

-Subnet

指定包含此 cmdlet 设置的前端 IP 配置的 Subnet 对象。

参数属性

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

参数集

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

-SubnetId

指定包含此 cmdlet 设置的前端 IP 配置的子网的 ID。

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

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

-Zone

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

参数属性

类型:

String[]

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

参数集

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

CommonParameters

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

输入

PSLoadBalancer

String

String

PSSubnet

PSPublicIpAddress

输出

PSLoadBalancer