通过

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

New-AzNetworkInterface

模块:
Az.Network Module

创建网络接口。

语法

SetByIpConfigurationResource （默认值） 

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

SetByIpConfigurationResourceId 

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
    [-EdgeZone <String>]
    [-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>]

SetByResourceId 

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -SubnetId <String>
    [-EdgeZone <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>]

SetByResource 

New-AzNetworkInterface
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -Subnet <PSSubnet>
    [-EdgeZone <String>]
    [-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

创建网络接口。 (autogenerated)

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 对象。

参数属性

类型:

PSApplicationGatewayBackendAddressPool[]

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

参数集

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

-ApplicationGatewayBackendAddressPoolId

指定 ApplicationGatewayBackendAddressPool 对象的 ID。

参数属性

类型:

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

-AsJob

在后台运行 cmdlet

参数属性

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

参数集

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

-AuxiliaryMode

网络接口的辅助模式

参数属性

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

参数集

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

-AuxiliarySku

网络接口的辅助 SKU

参数属性

类型:String
默认值:None
接受的值:None, A1, A2, A4, A8
支持通配符:False
不显示:False

参数集

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

-Confirm

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

参数属性

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

参数集

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

-DefaultProfile

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

参数属性

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

参数集

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

-DisableTcpStateTracking

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

参数属性

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

参数集

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

-DnsServer

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

参数属性

类型:

String[]

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

参数集

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

-EdgeZone

网络接口的边缘区域

参数属性

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

参数集

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

-EnableAcceleratedNetworking

启用加速网络。

参数属性

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

参数集

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

-EnableIPForwarding

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

参数属性

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

参数集

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

-Force

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

参数属性

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

参数集

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

-InternalDnsNameLabel

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

参数属性

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

参数集

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

-IpConfiguration

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

参数属性

类型:

PSNetworkInterfaceIPConfiguration[]

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

参数集

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

-IpConfigurationName

指定 IP 配置的名称。

参数属性

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

参数集

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

-LoadBalancerBackendAddressPool

指定 BackendAddressPool 对象。

参数属性

类型:

PSBackendAddressPool[]

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

参数集

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

-LoadBalancerBackendAddressPoolId

指定 BackendAddressPool 对象的 ID。

参数属性

类型:

String[]

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

参数集

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

-LoadBalancerInboundNatRule

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

参数属性

类型:

PSInboundNatRule[]

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

参数集

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

-LoadBalancerInboundNatRuleId

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

参数属性

类型:

String[]

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

参数集

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

-Location

指定网络接口的区域。

参数属性

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

参数集

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

-Name

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:资源名称

参数集

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

-NetworkSecurityGroup

指定 NetworkSecurityGroup 对象。

参数属性

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

参数集

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

-NetworkSecurityGroupId

指定网络安全组的 ID。

参数属性

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

参数集

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

-PrivateIpAddress

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

参数属性

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

参数集

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

-PublicIpAddress

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

参数属性

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

参数集

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

-PublicIpAddressId

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

参数属性

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

参数集

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

-ResourceGroupName

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

参数属性

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

参数集

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

-Subnet

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

参数属性

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

参数集

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

-SubnetId

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

参数属性

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

参数集

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

-Tag

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

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

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

CommonParameters

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

输入

String

PSNetworkInterfaceIPConfiguration

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Hashtable

输出

PSNetworkInterface