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

New-AzNetworkInterface

创建网络接口。

语法

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

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

-ApplicationGatewayBackendAddressPoolId

指定 ApplicationGatewayBackendAddressPool 对象的 ID

类型: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

-AsJob

在后台运行 cmdlet

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

-AuxiliaryMode

网络接口的辅助模式

类型:String
接受的值:None, MaxConnections, AcceleratedConnections, Floating
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AuxiliarySku

网络接口的辅助 SKU

类型:String
接受的值:None, A1, A2, A4, A8
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

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

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

-DefaultProfile

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

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

-DisableTcpStateTracking

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

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

-DnsServer

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

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

-EdgeZone

网络接口的边缘区域

类型: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 配置。

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

-IpConfigurationName

指定 IP 配置的名称。

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

-LoadBalancerBackendAddressPool

指定 BackendAddressPool 对象。

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

-LoadBalancerBackendAddressPoolId

指定 BackendAddressPool 对象的 ID

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

-LoadBalancerInboundNatRule

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

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

-LoadBalancerInboundNatRuleId

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

类型: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

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

输出

PSNetworkInterface