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

New-AzVmssIpConfig

为 VMSS 的网络接口创建 IP 配置。

语法

New-AzVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-PublicIPAddressVersion <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzVmssIpConfig cmdlet 为虚拟机规模集的网络接口创建 IP 配置对象, (VMSS) 。 将此 cmdlet 中的配置指定为 Add-AzVmssNetworkInterfaceConfiguration cmdlet 的 IPConfiguration 参数。

示例

示例 1:为 VMSS 接口创建 IP 配置对象

$IPConfiguration = New-AzVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

此命令创建名为 ContosoVmssInterface02 的 IP 配置对象。 该命令使用以前定义的子网 ID 存储在$SubnetId中。 该命令将配置设置存储在 $IPConfiguration 变量中,供以后与 Add-AzVmssNetworkInterfaceConfiguration 配合使用。

示例 2:创建包含 NAT 池设置的 IP 配置对象

$IPConfiguration = New-AzVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

此命令创建名为 ContosoVmssInterface03 的 IP 配置对象,然后将其存储在$IPConfiguration变量中供以后使用。 该命令使用以前定义的子网 ID 存储在$SubnetId中。 该命令将配置设置存储在$IPConfiguration变量中供以后使用。 该命令指定 LoadBalancerInboundNatPoolsIdLoadBalancerBackendAddressPoolsId 参数的值。

参数

-ApplicationGatewayBackendAddressPoolsId

指定对负载均衡器后端地址池的引用数组。 规模集可以引用一个公共负载均衡器和一个内部负载均衡器的后端地址池。 多个规模集不能使用相同的负载均衡器。

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

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DnsSetting

要应用于 publicIP 地址的 DNS 设置。 要应用于 publicIP 地址的 Dns 设置的域名标签。 域名标签和 VM 索引的串联将是将创建的公共 IP 地址资源的域名标签。

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

-Id

指定 ID。

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

-IpTag

指定 Ip 标记对象的数组。

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

-LoadBalancerBackendAddressPoolsId

指定对传入网络地址转换 (NAT) 负载均衡器池的引用数组。 规模集可以引用一个公共负载均衡器和一个内部负载均衡器的传入 NAT 池。 多个规模集不能使用相同的负载均衡器。

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

-LoadBalancerInboundNatPoolsId

指定对负载均衡器传入 NAT 池的引用数组。 规模集可以引用一个公共负载均衡器和一个内部负载均衡器的传入 NAT 池。 多个规模集不能使用相同的负载均衡器。

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

-Name

指定 IP 配置的名称。

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

-Primary

指定网络接口具有多个 IP 配置时的主要 IP 配置。

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

-PrivateIPAddressVersion

指定专用 IP 地址的 IP 配置。 默认值为 IPv4。 可能的值为:“IPv4”和“IPv6”。

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

公共 IP 地址的空闲超时。

Type:Int32
Aliases:PublicIPAddressIdleTimeoutInMinutes
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PublicIPAddressConfigurationName

publicIP 地址配置名称。

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

-PublicIPAddressVersion

指定公共 IP 地址的 IP 配置。 默认值为 IPv4。 可能的值为:“IPv4”和“IPv6”。

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

-PublicIPPrefix

公共 IP 前缀的 ID

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

-SubnetId

指定配置在其中创建 VMSS 网络接口的子网 ID。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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

输入

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

输出

VirtualMachineScaleSetIPConfiguration