你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Add-AzNetworkInterfaceIpConfig
将网络接口 IP 配置添加到网络接口。
语法
Add-AzNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
[-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
[-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
[-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
[-GatewayLoadBalancerId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Add-AzNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <String[]>]
[-LoadBalancerInboundNatRuleId <String[]>]
[-ApplicationGatewayBackendAddressPoolId <String[]>]
[-ApplicationSecurityGroupId <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Add-AzNetworkInterfaceIpConfig cmdlet 将网络接口 IP 配置添加到 Azure 网络接口。
示例
示例 1：使用应用程序安全组添加新的 IP 配置
$subnet = New-AzVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzVirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet
$nic = New-AzNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US" -Subnet $vnet.Subnets[0]
$asg = New-AzApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"
$nic | Set-AzNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface
$nic | Add-AzNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface在此示例中，我们将创建一个新的网络接口 MyNetworkInterface，该网络接口属于新虚拟网络 MyVNET 中的子网。 我们还创建一个空的应用程序安全组 MyASG，以与网络接口中的 IP 配置相关联。 创建这两个对象后，我们将默认 IP 配置链接到 MyASG 对象。 最后，我们在网络接口中创建新的 IP 配置，也链接到应用程序安全组对象。
参数
-ApplicationGatewayBackendAddressPool
指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。
| 类型: | PSApplicationGatewayBackendAddressPool[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ApplicationGatewayBackendAddressPoolId
指定此网络接口 IP 配置所属的应用程序网关后端地址池引用的集合。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ApplicationSecurityGroup
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
| 类型: | PSApplicationSecurityGroup[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ApplicationSecurityGroupId
指定此网络接口 IP 配置所属的应用程序安全组引用的集合。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-GatewayLoadBalancerId
网关 LoadBalancer 提供程序资源的引用。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-LoadBalancerBackendAddressPool
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
| 类型: | PSBackendAddressPool[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-LoadBalancerBackendAddressPoolId
指定此网络接口 IP 配置所属的负载均衡器后端地址池引用的集合。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-LoadBalancerInboundNatRule
指定此网络接口 IP 配置所属的负载均衡器入站网络地址转换（NAT）规则引用的集合。
| 类型: | PSInboundNatRule[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-LoadBalancerInboundNatRuleId
指定此网络接口 IP 配置所属的负载均衡器入站 NAT 规则引用的集合。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定网络接口 IP 配置的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NetworkInterface
指定 NetworkInterface 对象。 此 cmdlet 将网络接口 IP 配置添加到此参数指定的对象。
| 类型: | PSNetworkInterface |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Primary
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrivateIpAddress
指定网络接口 IP 配置的静态 IP 地址。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrivateIpAddressVersion
指定网络接口 IP 配置的 IP 地址版本。 此参数的可接受值为：
- IPv4
- IPv6
| 类型: | String |
| 接受的值: | IPv4, IPv6 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicIpAddress
指定 PublicIPAddress 对象。 此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。
| 类型: | PSPublicIpAddress |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicIpAddressId
此 cmdlet 创建对公共 IP 地址的引用，以与此网络接口 IP 配置相关联。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Subnet
指定 Subnet 对象。 此 cmdlet 创建对此网络接口 IP 配置的子网的引用。
| 类型: | PSSubnet |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SubnetId
此 cmdlet 创建对此网络接口 IP 配置的子网的引用。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
String[]
PSApplicationGatewayBackendAddressPool[]
输出
备注
- 关键字：azure， azurerm， arm， 资源， 管理， 经理， 网络， 网络