次の方法で共有


Add-AzureRmNetworkInterfaceIpConfig

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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>]
Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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>]

説明

Add-AzureRmNetworkInterfaceIpConfig コマンドレットは、ネットワーク インターフェイス IP 構成を Azure ネットワーク インターフェイスに追加します。

例 1: アプリケーション セキュリティ グループを使用して新しい IP 構成を追加する

$subnet = New-AzureRmVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzureRmvirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzureRmNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US"  -Subnet $vnet.Subnets[0]

$asg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzureRmNetworkInterface

$nic | Add-AzureRmNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg  | Set-AzureRmNetworkInterface

この例では、新しい仮想ネットワーク MyVNET 内のサブネットに属する新しいネットワーク インターフェイス MyNetworkInterface を作成します。 また、ネットワーク インターフェイスの IP 構成に関連付ける空のアプリケーション セキュリティ グループ MyASG も作成します。 両方のオブジェクトが作成されたら、既定の IP 構成を MyASG オブジェクトにリンクします。 最後に、ネットワーク インターフェイスにもアプリケーション セキュリティ グループ オブジェクトにリンクされた新しい IP 構成を作成します。

パラメーター

-ApplicationGatewayBackendAddressPool

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

型:List<T>[PSApplicationGatewayBackendAddressPool]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ApplicationGatewayBackendAddressPoolId

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

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ApplicationSecurityGroup

このネットワーク インターフェイス IP 構成が属するアプリケーション セキュリティ グループ参照のコレクションを指定します。

型:List<T>[PSApplicationSecurityGroup]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ApplicationSecurityGroupId

このネットワーク インターフェイス IP 構成が属するアプリケーション セキュリティ グループ参照のコレクションを指定します。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LoadBalancerBackendAddressPool

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

型:List<T>[PSBackendAddressPool]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LoadBalancerBackendAddressPoolId

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

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LoadBalancerInboundNatRule

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

型:List<T>[PSInboundNatRule]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LoadBalancerInboundNatRuleId

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

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NetworkInterface

NetworkInterface オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するオブジェクトにネットワーク インターフェイス IP 構成を追加します。

型:PSNetworkInterface
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Primary

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrivateIpAddress

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
型:String
指定可能な値:IPv4, IPv6
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublicIpAddress

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

型:PSPublicIpAddress
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublicIpAddressId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Subnet

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

型:PSSubnet
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SubnetId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

PSNetworkInterface

パラメーター: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

出力

PSNetworkInterface

メモ

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