次の方法で共有

Set-AzureRmNetworkInterfaceIpConfig

  • リファレンス
モジュール:
AzureRM.Network

Azure ネットワーク インターフェイスの IP 構成の目標の状態を設定します。

警告

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

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Set-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>]
Set-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>]

説明

Set-AzureRmNetworkInterfaceIpConfig コマンドレットは、Azure ネットワーク インターフェイスの IP 構成の目標の状態を設定します。

例

1: IP 構成の IP アドレスを変更する

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
    -Primary

$nic | Set-AzureRmNetworkInterface

最初の 2 つのコマンドは、myvnet と呼ばれる仮想ネットワークと mysubnet というサブネットを取得し、それぞれ$vnet変数と$subnetに格納します。 3 番目のコマンドは、更新する必要がある IP 構成に関連付けられているネットワーク インターフェイス nic1 を取得します。 3 番目のコマンドは、プライマリ IP 構成 ipconfig1 のプライベート IP アドレスを 10.0.0.11 に設定します。 最後に、最後のコマンドは、変更が正常に行われていることを確認するネットワーク インターフェイスを更新します。

2: IP 構成とアプリケーション セキュリティ グループの関連付け

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
    -Primary

$nic | Set-AzureRmNetworkInterface

この例では、$asg変数にアプリケーション セキュリティ グループへの参照が含まれています。 4 番目のコマンドは、更新する必要がある IP 構成に関連付けられているネットワーク インターフェイス nic1 を取得します。 Set-AzureRmNetworkInterfaceIpConfig は、プライマリ IP 構成 ipconfig1 のプライベート IP アドレスを 10.0.0.11 に設定し、取得したアプリケーション セキュリティ グループとの関連付けを作成します。 最後に、最後のコマンドは、変更が正常に行われていることを確認するネットワーク インターフェイスを更新します。

パラメーター

-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, リソース, 管理, マネージャー, ネットワーク, ネットワーク