共用方式為


New-AzNetworkInterfaceIpConfig

建立網路介面 IP 組態。

語法

SetByResource (預設值)

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

New-AzNetworkInterfaceIpConfig Cmdlet 會建立網路介面的 Azure 網路介面 IP 設定。

範例

範例 1:建立具有網路介面公用 IP 位址的 IP 組態

$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 mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig1

前兩個命令會分別取得先前建立的名為 myvnet 的虛擬網路和稱為 mysubnet 的子網路。 這些分別存儲在$vnet和$Subnet中。 第三個命令會取得先前建立的名為 PIP1 的公用 IP 位址。 第四個命令會建立名為「IPConfig-1」的新IP配置,作為主要IP配置,並具有與之關聯的公共IP地址。 然後,最後一個命令使用此IP配置創建一個名為mynic1的網路介面。

範例 2:使用私人 IP 位址建立 IP 組態

$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的網路介面。

範例 3

建立網路介面 IP 組態。 (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

參數

-ApplicationGatewayBackendAddressPool

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

參數屬性

類型:

PSApplicationGatewayBackendAddressPool[]

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

參數集

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

-ApplicationGatewayBackendAddressPoolId

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

參數屬性

類型:

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

-DefaultProfile

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

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

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

-GatewayLoadBalancerId

閘道 LoadBalancer 提供者資源的參照。

參數屬性

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

參數集

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

-LoadBalancerBackendAddressPool

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

參數屬性

類型:

PSBackendAddressPool[]

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

參數集

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

-LoadBalancerBackendAddressPoolId

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

參數屬性

類型:

String[]

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

參數集

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

-LoadBalancerInboundNatRule

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

參數屬性

類型:

PSInboundNatRule[]

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

參數集

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

-LoadBalancerInboundNatRuleId

指定此網路介面 IP 組態所屬的負載平衡器輸入網路位址轉譯 (NAT) 規則參照集合。

參數屬性

類型:

String[]

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

參數集

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

-Name

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

參數屬性

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

參數集

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

-Primary

New-AzNetworkInterfaceIpConfig Cmdlet 會建立網路介面的 Azure 網路介面 IP 設定。

參數屬性

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

參數集

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

-PrivateIpAddress

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

參數屬性

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

參數集

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

-PrivateIPAddressPrefixLength

指定網路介面 IP 組態的靜態 IP 位址前置詞長度。

參數屬性

類型:

Nullable<T>[Int32]

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

參數集

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

-PrivateIpAddressVersion

指定網路介面 IP 組態的 IP 位址版本。 此參數可接受的值為:

  • IPv4
  • IPv6

參數屬性

類型:String
預設值:None
接受的值:IPv4, IPv6
支援萬用字元:False
不要顯示:False

參數集

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

-PublicIpAddress

指定 PublicIPAddress 物件。 此 Cmdlet 會建立公用 IP 位址的參考,以與此網路介面 IP 設定相關聯。

參數屬性

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

參數集

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

-PublicIpAddressId

此 Cmdlet 會建立公用 IP 位址的參考,以與此網路介面 IP 設定相關聯。

參數屬性

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

參數集

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

-Subnet

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

參數屬性

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

參數集

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

-SubnetId

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

參數屬性

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

參數集

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

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

輸出

PSNetworkInterfaceIPConfiguration

備註

  • 關鍵詞:azure、azurerm、arm、資源、管理、管理器、網絡、網絡