New-AzNetworkInterfaceIpConfig

模組:

Az.Network

建立網路介面IP組態。

語法

PowerShell

New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

PowerShell

New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzNetworkInterfaceIpConfig Cmdlet 會建立網路介面的 Azure 網路介面 IP 組態。

範例

1：使用網路介面的公用IP位址建立IP組態

PowerShell

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIPAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1
    -Primary

 $nic = New-AzNetworkInterface -Name $NicName -ResourceGroupName myrg -Location westus
    -IpConfiguration $IpConfig1

前兩個命令會分別取得名為 myvnet 的虛擬網路和名為 mysubnet 的子網。 這些分別儲存在$vnet和$Subnet中。 第三個命令會取得先前建立的公用IP位址，稱為PIP1。 forth 命令會建立名為 「IPConfig-1」 的新 IP 組態，作為與 IP 位址相關聯的公用 IP 位址的主要 IP 組態。 最後一個命令接著會使用此IP組態建立名為 mynic1 的網路介面。

2：使用私人IP位址建立IP組態

PowerShell

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress
    10.0.0.5

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration
    $IpConfig2

前兩個命令會分別取得名為 myvnet 的虛擬網路和名為 mysubnet 的子網。 這些分別儲存在$vnet和$Subnet中。 第三個命令會建立名為 「IPConfig-2」 的新 IP 組態，並建立與其相關聯的私人 IP 位址 10.0.0.5。 最後一個命令接著會使用此IP組態建立名為 mynic1 的網路介面。

參數

-ApplicationGatewayBackendAddressPool

指定此網路介面IP組態所屬的應用程式閘道後端位址池參考集合。

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

-ApplicationGatewayBackendAddressPoolId

指定此網路介面IP組態所屬的應用程式閘道後端位址池參考集合。

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

-ApplicationSecurityGroup

指定此網路介面IP組態所屬的應用程式安全組參考集合。

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

-ApplicationSecurityGroupId

指定此網路介面IP組態所屬的應用程式安全組參考集合。

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LoadBalancerBackendAddressPool

指定此網路介面IP組態所屬的負載平衡器後端位址池參考集合。

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

-LoadBalancerBackendAddressPoolId

指定此網路介面IP組態所屬的負載平衡器後端位址池參考集合。

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

-LoadBalancerInboundNatRule

指定此網路介面IPConfiguration所屬的負載平衡器輸入Nat規則參考集合。

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

-LoadBalancerInboundNatRuleId

指定此網路介面IP組態所屬的負載平衡器輸入網路位址轉換 （NAT） 規則參考集合。

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

-Name

指定網路介面IP組態的名稱。

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

-Primary

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

-PrivateIpAddress

指定網路介面IP組態的靜態IP位址。

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

-PrivateIpAddressVersion

指定網路介面IP組態的IP位址版本。

此參數可接受的值為：

• IPv4
• IPv6

類型:	String
接受的值:	IPv4, IPv6
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicIpAddress

指定 PublicIPAddress 物件。 此 Cmdlet 會建立公用 IP 位址的參考，以與此網路介面 IP 組態產生關聯。

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

-PublicIpAddressId

此 Cmdlet 會建立公用 IP 位址的參考，以與此網路介面 IP 組態產生關聯。

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

-Subnet

指定 Subnet 物件。 此 Cmdlet 會建立建立此網路介面 IP 組態之子網的參考。

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

-SubnetId

指定建立此網路介面IP組態之子網的參考。

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

輸出

PSNetworkInterfaceIPConfiguration

備註

• 關鍵詞：azure、azurerm、arm、resource、management、manager、network、networking

相關連結

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig
• Set-AzNetworkInterfaceIpConfig