你当前正在访问 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

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

类型:String[]
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DnsSetting

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

类型:String
别名:PublicIPAddressDomainNameLabel
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Id

指定 ID。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-IpTag

指定 Ip Tag 对象的数组。

类型:VirtualMachineScaleSetIpTag[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-LoadBalancerBackendAddressPoolsId

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

类型:String[]
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-LoadBalancerInboundNatPoolsId

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

类型:String[]
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Name

指定 IP 配置的名称。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Primary

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PrivateIPAddressVersion

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicIPAddressConfigurationIdleTimeoutInMinutes

公共 IP 地址的空闲超时。

类型:Int32
别名:PublicIPAddressIdleTimeoutInMinutes
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicIPAddressConfigurationName

publicIP 地址配置名称。

类型:String
别名:PublicIPAddressName
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicIPAddressVersion

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicIPPrefix

公共 IP 前缀的 ID

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SubnetId

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

类型:String
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

输出

VirtualMachineScaleSetIPConfiguration