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 |
入力
パラメーター: 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]]
出力
メモ
- キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, ネットワーク, ネットワーク