你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureRmVmssIpConfig
为 VMSS 的网络接口创建 IP 配置。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
New-AzureRmVmssIpConfig
[[-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>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
New-AzureRmVmssIpConfig cmdlet 为虚拟机规模集（VMSS）的网络接口创建 IP 配置对象。 将此 cmdlet 中的配置指定为 Add-AzureRmVmssNetworkInterfaceConfiguration cmdlet 的 IPConfiguration 参数。
示例
示例 1：为 VMSS 接口创建 IP 配置对象
PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId此命令创建名为 ContosoVmssInterface02 的 IP 配置对象。 该命令使用以前定义的子网 ID 存储在$SubnetId中。 该命令将配置设置存储在 $IPConfiguration 变量中，以便稍后与 Add-AzureRmVmssNetworkInterfaceConfiguration 一起使用。
示例 2：创建包含 NAT 池设置的 IP 配置对象
PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -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 |
| 别名: | 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 配置为 IPv4 或 IPv6。 默认值被视为 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 |
-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[]
输出
VirtualMachineScaleSetIPConfiguration