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

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 的網路介面，該介面會使用儲存在名為 $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 物件的識別碼。

參數屬性

類型:	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
別名:	參見

參數集

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

參數屬性

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

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

參數屬性

類型:	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 物件識別碼。

參數屬性

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

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SetByResourceId

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Tag

雜湊表形式的鍵值對。例如：@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

類型:	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。

輸出

PSNetworkInterface

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzNetworkInterface

語法

SetByIpConfigurationResource (預設值)

SetByIpConfigurationResourceId

SetByResourceId

SetByResource

Description

範例

範例 1：建立 Azure 網路介面

範例 2：使用 IP 組態物件建立 Azure 網路介面

範例 3

參數

-ApplicationGatewayBackendAddressPool

參數屬性

參數集

-ApplicationGatewayBackendAddressPoolId

參數屬性

參數集

-ApplicationSecurityGroup

參數屬性

參數集

-ApplicationSecurityGroupId

參數屬性

參數集

-AsJob

參數屬性

參數集

-AuxiliaryMode

參數屬性

參數集

-AuxiliarySku

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DisableTcpStateTracking

參數屬性

參數集

-DnsServer

參數屬性

參數集

-EdgeZone

參數屬性

參數集

-EnableAcceleratedNetworking

參數屬性

參數集

-EnableIPForwarding

參數屬性

參數集

-Force

參數屬性

參數集

-InternalDnsNameLabel

參數屬性

參數集

-IpConfiguration

參數屬性

參數集

-IpConfigurationName

參數屬性

參數集

-LoadBalancerBackendAddressPool

參數屬性

參數集

-LoadBalancerBackendAddressPoolId

參數屬性

參數集

-LoadBalancerInboundNatRule

參數屬性

參數集

-LoadBalancerInboundNatRuleId

參數屬性

參數集

-Location