共用方式為

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

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 物件。

類型:PSApplicationGatewayBackendAddressPool[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ApplicationGatewayBackendAddressPoolId

指定 ApplicationGatewayBackendAddressPool 對象的識別碼。

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

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-LoadBalancerInboundNatRule

指定負載平衡器的輸入NAT規則組態。

類型:PSInboundNatRule[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-LoadBalancerInboundNatRuleId

指定負載平衡器的輸入NAT規則組態標識碼。

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

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

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

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

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

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