New-AzNetworkInterface

參考

模組:: Az.Network

建立網路介面。

Syntax

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>]

Description

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"

此命令會建立名為 NetworkInterface001 的網路介面，並在名為 VirtualNetwork1 的虛擬網路中，從 Subnet1 動態指派私人 IP 位址。此命令也會將兩部 DNS 伺服器指派給網路介面。 IPConfiguration 子資源將會使用IPConfiguration1名稱自動建立。

範例 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 的網路介面，該網路介面 IP 組態會使用儲存在名為 $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 對象的識別碼。

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 物件的識別碼。

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規則組態標識碼。

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

指定網路安全組的識別碼。

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 物件的標識碼。

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

指定要為其建立網路介面之子網的標識碼。

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