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

New-AzNetworkInterface

参考

模块:: Az.Network

创建网络接口。

语法

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
   [-NetworkSecurityGroupId <String>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -SubnetId <String>
   [-PublicIpAddressId <String>]
   [-NetworkSecurityGroupId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -Subnet <PSSubnet>
   [-PublicIpAddress <PSPublicIpAddress>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

示例

示例 1：创建 Azure 网络接口

New-AzNetworkInterface -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 网络接口

$Subnet = Get-AzVirtualNetwork -Name "VirtualNetwork1" -ResourceGroupName "ResourceGroup1" 
$IPconfig = New-AzNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId $Subnet.Subnets[0].Id
New-AzNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

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

示例 3

创建网络接口。（自动生成）

New-AzNetworkInterface -Location 'West US' -Name 'NetworkInterface1' -PrivateIpAddress '10.0.1.10' -ResourceGroupName 'ResourceGroup1' -SubnetId '/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1'

参数

-ApplicationGatewayBackendAddressPool

指定 ApplicationGatewayBackendAddressPool 对象。

Type:	PSApplicationGatewayBackendAddressPool[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationGatewayBackendAddressPoolId

指定 ApplicationGatewayBackendAddressPool 对象的 ID。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroup

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

Type:	PSApplicationSecurityGroup[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroupId

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

在后台运行 cmdlet

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuxiliaryMode

网络接口的辅助模式

Type:	String
Accepted values:	None, MaxConnections, AcceleratedConnections, Floating
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuxiliarySku

网络接口的辅助 SKU

Type:	String
Accepted values:	None, A1, A2, A4, A8
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableTcpStateTracking

指示是否禁用 tcp 状态跟踪。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DnsServer

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EdgeZone

网络接口的边缘区域

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableAcceleratedNetworking

启用加速网络。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableIPForwarding

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InternalDnsNameLabel

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IpConfiguration

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

Type:	PSNetworkInterfaceIPConfiguration[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IpConfigurationName

指定 IP 配置的名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPool

指定 BackendAddressPool 对象。

Type:	PSBackendAddressPool[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPoolId

指定 BackendAddressPool 对象的 ID。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRule

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

Type:	PSInboundNatRule[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRuleId

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

指定网络接口的区域。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkSecurityGroup

指定 NetworkSecurityGroup 对象。

Type:	PSNetworkSecurityGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkSecurityGroupId

指定网络安全组的 ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PrivateIpAddress

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpAddress

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

Type:	PSPublicIpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpAddressId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Subnet

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

Type:	PSSubnet
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubnetId

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

String

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

输出

PSNetworkInterface