New-AzNetworkInterfaceIpConfig

ネットワーク インターフェイスの IP 構成を作成します。

構文

New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzNetworkInterfaceIpConfig コマンドレットは、ネットワーク インターフェイスの 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

最初の 2 つのコマンドは、myvnet と呼ばれる仮想ネットワークと、以前に作成された mysubnet というサブネットをそれぞれ取得します。 これらはそれぞれ$vnetと$Subnetに格納されます。 3 番目のコマンドは、PIP1 という名前の以前に作成されたパブリック IP アドレスを取得します。 次のコマンドでは、パブリック IP アドレスが関連付けられたプライマリ IP 構成として、"IPConfig-1" という名前の新しい 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

最初の 2 つのコマンドは、myvnet と呼ばれる仮想ネットワークと、以前に作成された mysubnet というサブネットをそれぞれ取得します。 これらはそれぞれ$vnetと$Subnetに格納されます。 3 番目のコマンドは、プライベート IP アドレス 10.0.0.5 が関連付けられた "IPConfig-2" という名前の新しい IP 構成を作成します。 最後のコマンドは、この IP 構成を使用して mynic1 というネットワーク インターフェイスを作成します。

例 3

ネットワーク インターフェイスの IP 構成を作成します。 (自動生成)

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

パラメーター

-ApplicationGatewayBackendAddressPool

このネットワーク インターフェイス IP 構成が属するアプリケーション ゲートウェイ バックエンド アドレス プール参照のコレクションを指定します。

Type:PSApplicationGatewayBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationGatewayBackendAddressPoolId

このネットワーク インターフェイス IP 構成が属するアプリケーション ゲートウェイ バックエンド アドレス プール参照のコレクションを指定します。

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewayLoadBalancerId

ゲートウェイ LoadBalancer プロバイダー リソースの参照。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPool

このネットワーク インターフェイス IP 構成が属するロード バランサー バックエンド アドレス プール参照のコレクションを指定します。

Type:PSBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPoolId

このネットワーク インターフェイス IP 構成が属するロード バランサー バックエンド アドレス プール参照のコレクションを指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRule

このネットワーク インターフェイス IPConfiguration が属するロード バランサーの受信 Nat 規則参照のコレクションを指定します。

Type:PSInboundNatRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRuleId

このネットワーク インターフェイス IP 構成が属するロード バランサーの受信ネットワーク アドレス変換 (NAT) 規則参照のコレクションを指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

ネットワーク インターフェイスの IP 構成の名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Primary

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddress

ネットワーク インターフェイス IP 構成の静的 IP アドレスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddressVersion

ネットワーク インターフェイスの IP 構成の IP アドレス バージョンを指定します。 このパラメーターの有効値は、次のとおりです。

  • IPv4
  • IPv6
Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddress

PublicIPAddress オブジェクトを指定します。 このコマンドレットは、このネットワーク インターフェイス IP 構成に関連付けるパブリック IP アドレスへの参照を作成します。

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

このコマンドレットは、このネットワーク インターフェイス IP 構成に関連付けるパブリック IP アドレスへの参照を作成します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

Subnet オブジェクトを指定します。 このコマンドレットは、このネットワーク インターフェイス IP 構成が作成されるサブネットへの参照を作成します。

Type:PSSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

このネットワーク インターフェイス IP 構成が作成されるサブネットへの参照を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

出力

PSNetworkInterfaceIPConfiguration

メモ

  • キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, ネットワーク, ネットワーク