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

New-AzureRmNetworkInterface

模块:

AzureRM.Network

创建网络接口。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行，但不再受到维护或支持，任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-NetworkSecurityGroupId <String>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -SubnetId <String>
   [-PublicIpAddressId <String>]
   [-NetworkSecurityGroupId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Subnet <PSSubnet>
   [-PublicIpAddress <PSPublicIpAddress>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzureRmNetworkInterface cmdlet 创建 Azure 网络接口。

示例

示例 1：创建 Azure 网络接口

PS C:\>New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1" -IpConfigurationName "IPConfiguration1" -DnsServer "8.8.8.8", "8.8.4.4"

此命令在名为 VirtualNetwork1 的虚拟网络中创建名为 NetworkInterface001 的网络接口，其中包含来自 Subnet1 的动态分配的专用 IP 地址。 该命令还会将两个 DNS 服务器分配给网络接口。 将使用名称 IPConfiguration1 自动创建 IPConfiguration 子资源。

示例 2：使用 IP 配置对象创建 Azure 网络接口

PS C:\>$IPconfig = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1"
PS C:\> New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

此示例使用 IP 配置对象创建新的网络接口。 IP 配置对象指定静态专用 IPv4 地址。 第一个命令创建名为 IPConfig1 的网络接口 IP 配置，并将配置存储在名为$IPconfig的变量中。 第二个命令创建名为 NetworkInterface1 的网络接口，该接口使用存储在名为 $IPconfig 变量中的网络接口 IP 配置。

参数

-ApplicationGatewayBackendAddressPool

指定 ApplicationGatewayBackendAddressPool 对象。

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

-ApplicationGatewayBackendAddressPoolId

指定 ApplicationGatewayBackendAddressPool 对象的 ID。

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

-ApplicationSecurityGroup

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

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

-ApplicationSecurityGroupId

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

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

-AsJob

在后台运行 cmdlet

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

-Confirm

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

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

-DefaultProfile

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

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

-DnsServer

指定网络接口的 DNS 服务器。

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

-EnableAcceleratedNetworking

启用加速网络。

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

-EnableIPForwarding

指示此 cmdlet 为网络接口启用 IP 转发。 IP 转发允许虚拟机接收发往其他目标的流量。

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

-Force

即使已存在具有相同名称的网络接口，也强制创建网络接口。

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

-InternalDnsNameLabel

指定新网络接口的内部 DNS 名称标签。

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

-IpConfiguration

指定此 cmdlet 用于网络接口的 IP 配置。

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

-IpConfigurationName

指定 IP 配置的名称。

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

-LoadBalancerBackendAddressPool

指定 BackendAddressPool 对象。

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

-LoadBalancerBackendAddressPoolId

指定 BackendAddressPool 对象的 ID。

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

-LoadBalancerInboundNatRule

指定负载均衡器的入站 NAT 规则配置。

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

-LoadBalancerInboundNatRuleId

指定负载均衡器的入站 NAT 规则配置的 ID。

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

-Location

指定网络接口的区域。

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

-Name

指定要创建的网络接口的名称。

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

-NetworkSecurityGroup

指定 NetworkSecurityGroup 对象。

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

-NetworkSecurityGroupId

指定网络安全组的 ID。

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

-PrivateIpAddress

指定要分配给此网络接口的静态 IPv4 IP 地址。

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

-PublicIpAddress

指定要 分配给网络接口的 PublicIPAddress 对象。

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

-PublicIpAddressId

指定要分配给网络接口的 PublicIPAddress 对象的 ID。

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

-ResourceGroupName

指定网络接口所属的资源组的名称。

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

-Subnet

指定 Subnet 对象。 此 cmdlet 为此参数指定的子网创建网络接口。

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

-SubnetId

指定要为其创建网络接口的子网的 ID。

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

-Tag

以哈希表的形式进行键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

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

-WhatIf

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

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

输入

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Hashtable

输出

PSNetworkInterface

相关链接

• Get-AzureRmNetworkInterface
• Remove-AzureRmNetworkInterface
• Set-AzureRmNetworkInterface