通过

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

New-AzNetworkInterfaceIpConfig

模块:
Az.Network Module

创建网络接口 IP 配置。

语法

SetByResource （默认值） 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

New-AzNetworkInterfaceIpConfig cmdlet 为网络接口创建 Azure 网络接口 IP 配置。

示例

示例 1：使用网络接口的公共 IP 地址创建 IP 配置

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1 -Primary

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig1

前两个命令分别获取名为 myvnet 的虚拟网络和分别创建的名为 mysubnet 的子网。 这些存储分别存储在$vnet和$Subnet中。 第三个命令获取以前创建的名为 PIP1 的公共 IP 地址。 第四个命令创建一个名为“IPConfig-1”的新 IP 配置，作为与 IP 地址关联的公共 IP 地址的主要 IP 配置。 然后，最后一个命令使用此 IP 配置创建名为 mynic1 的网络接口。

示例 2：使用专用 IP 地址创建 IP 配置

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress 10.0.0.5

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig2

前两个命令分别获取名为 myvnet 的虚拟网络和分别创建的名为 mysubnet 的子网。 这些存储分别存储在$vnet和$Subnet中。 第三个命令创建名为“IPConfig-2”的新 IP 配置，该配置具有与之关联的专用 IP 地址 10.0.0.5。 然后，最后一个命令使用此 IP 配置创建名为 mynic1 的网络接口。

示例 3

创建网络接口 IP 配置。 (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

参数

-ApplicationGatewayBackendAddressPool

指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。

参数属性

类型:

PSApplicationGatewayBackendAddressPool[]

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ApplicationGatewayBackendAddressPoolId

指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。

参数属性

类型:

String[]

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ApplicationSecurityGroup

指定此网络接口 IP 配置所属的应用程序安全组引用的集合。

参数属性

类型:

PSApplicationSecurityGroup[]

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ApplicationSecurityGroupId

指定此网络接口 IP 配置所属的应用程序安全组引用的集合。

参数属性

类型:

String[]

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-DefaultProfile

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

参数属性

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

参数集

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

-GatewayLoadBalancerId

网关 LoadBalancer 提供程序资源的引用。

参数属性

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-LoadBalancerBackendAddressPool

指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。

参数属性

类型:

PSBackendAddressPool[]

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-LoadBalancerBackendAddressPoolId

指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。

参数属性

类型:

String[]

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-LoadBalancerInboundNatRule

指定此网络接口 IPConfiguration 所属的负载均衡器入站 Nat 规则引用的集合。

参数属性

类型:

PSInboundNatRule[]

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-LoadBalancerInboundNatRuleId

指定此网络接口 IP 配置所属的负载均衡器入站网络地址转换（NAT）规则引用的集合。

参数属性

类型:

String[]

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Name

指定网络接口 IP 配置的名称。

参数属性

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

参数集

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

-Primary

New-AzNetworkInterfaceIpConfig cmdlet 为网络接口创建 Azure 网络接口 IP 配置。

参数属性

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

参数集

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

-PrivateIpAddress

指定网络接口 IP 配置的静态 IP 地址。

参数属性

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

参数集

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

-PrivateIPAddressPrefixLength

指定网络接口 IP 配置的静态 IP 地址前缀长度。

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-PrivateIpAddressVersion

指定网络接口 IP 配置的 IP 地址版本。 此参数的可接受值为：

  • IPv4
  • IPv6

参数属性

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

参数集

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

-PublicIpAddress

指定 PublicIPAddress 对象。 此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。

参数属性

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PublicIpAddressId

此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。

参数属性

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Subnet

指定 子网 对象。 此 cmdlet 创建对此网络接口 IP 配置的子网的引用。

参数属性

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

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SubnetId

指定对在其中创建此网络接口 IP 配置的子网的引用。

参数属性

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

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

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

输入

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

输出

PSNetworkInterfaceIPConfiguration

备注

  • 关键字：azure， azurerm， arm， 资源， 管理， 经理， 网络， 网络