你当前正在访问 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 为虚拟机规模集(VMSS)的网络接口创建 IP 配置对象。 将此 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变量中供以后使用。 该命令指定 LoadBalancerInboundNatPoolsId 和 LoadBalancerBackendAddressPoolsId 参数的值

参数

-ApplicationGatewayBackendAddressPoolsId

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

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

-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

-DnsSetting

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

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

-Id

指定 ID。

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

-IpTag

指定 Ip Tag 对象的数组。

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

-LoadBalancerBackendAddressPoolsId

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

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

-LoadBalancerInboundNatPoolsId

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

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

-Name

指定 IP 配置的名称。

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

-Primary

指定主 IP 配置,以防网络接口具有多个 IP 配置。

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

-PrivateIPAddressVersion

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

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

公共 IP 地址的空闲超时。

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

-PublicIPAddressConfigurationName

publicIP 地址配置名称。

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

-PublicIPAddressVersion

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

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

-PublicIPPrefix

公共 IP 前缀的 ID

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

-SubnetId

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

Type:String
Position:2
Default value:None
Required:False
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

输入

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

输出

VirtualMachineScaleSetIPConfiguration