Set-AzureRmNetworkInterface
ネットワーク インターフェイスの目標の状態を設定します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureRmNetworkInterface
-NetworkInterface <PSNetworkInterface>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Set-AzureRmNetworkInterface は、Azure ネットワーク インターフェイスの目標の状態を設定します。
例
例 1: ネットワーク インターフェイスを構成する
$Nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzureRmNetworkInterface -NetworkInterface $Nic
この例では、ネットワーク インターフェイスを構成します。 最初のコマンドは、リソース グループ ResourceGroup1 の NetworkInterface1 という名前のネットワーク インターフェイスを取得します。 2 番目のコマンドは、IP 構成のプライベート IP アドレスを設定します。 3 番目のコマンドは、プライベート IP 割り当て方法を Static に設定します。 4 番目のコマンドは、ネットワーク インターフェイスにタグを設定します。 5 番目のコマンドは、$Nic変数に格納されている情報を使用して、ネットワーク インターフェイスを設定します。
例 2: ネットワーク インターフェイスの DNS 設定を変更する
$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterface
最初のコマンドは、リソース グループ ResourceGroup1 内に存在する NetworkInterface1 という名前のネットワーク インターフェイスを取得します。 2 番目のコマンドは、このインターフェイスに DNS サーバー 192.168.1.100 を追加します。 3 番目のコマンドは、これらの変更をネットワーク インターフェイスに適用します。 DNS サーバーを削除するには、上記のコマンドに従いますが、置き換えてください。Add" with ".2 番目のコマンドで "Remove" を選択します。
例 3: ネットワーク インターフェイスで IP の許可を有効にする
$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzureRmNetworkInterface
最初のコマンドは、NetworkInterface1 という名前の既存のネットワーク インターフェイスを取得し、$nic変数に格納します。 2 番目のコマンドは、IP 転送の値を true に変更します。 最後に、3 番目のコマンドは、ネットワーク インターフェイスに変更を適用します。 ネットワーク インターフェイスで IP 転送を無効にするには、サンプルの例に従いますが、必ず 2 番目のコマンドを "$nic" に変更してください。EnableIPForwarding = 0"
例 4: ネットワーク インターフェイスのサブネットを変更する
$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzureRmVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzureRmVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzureRmNetworkInterface
最初のコマンドは、ネットワーク インターフェイス NetworkInterface1 を取得し、$nic変数に格納します。 2 番目のコマンドは、ネットワーク インターフェイスが関連付けられるサブネットに関連付けられている仮想ネットワークを取得します。 2 番目のコマンドは、サブネットを取得し、$subnet 2 変数に格納します。 3 番目のコマンドは、ネットワーク インターフェイスのプライマリ プライベート IP アドレスを新しいサブネットに関連付けました。 最後に、最後のコマンドによって、これらの変更がネットワーク インターフェイスに適用されました。
Note
IP 構成は、サブネットを変更する前に動的である必要があります。 静的 IP 構成がある場合は、続行する前に動的に変更します。
Note
ネットワーク インターフェイスに複数の IP 構成がある場合は、最終的な Set-AzureRmNetworkInterface コマンドを実行する前に、これらすべての IP 構成に対して 4 番目のコマンドを実行する必要があります。 これは、4 番目のコマンドと同様に実行できますが、"0" を適切な数値に置き換えます。 ネットワーク インターフェイスに N 個の IP 構成がある場合は、これらのコマンドの N-1 が存在する必要があります。
例 5: ネットワーク セキュリティ グループをネットワーク インターフェイスに関連付ける/関連付けを解除する
$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterface
最初のコマンドは、NetworkInterface1 という名前の既存のネットワーク インターフェイスを取得し、$nic変数に格納します。 2 番目のコマンドは、MyNSG という名前の既存のネットワーク セキュリティ グループを取得し、$nsg変数に格納します。 次のコマンドは、$nicに$nsgを割り当てます。 最後に、5 番目のコマンドは、ネットワーク インターフェイスに変更を適用します。 ネットワーク インターフェイスからネットワーク セキュリティ グループの関連付けを解除するには、次のコマンドの$nsgを$nullに置き換えます。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NetworkInterface
ネットワーク インターフェイスの 目標の状態を表す NetworkInterface オブジェクトを指定します。
型: | PSNetworkInterface |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
パラメーター: NetworkInterface (ByValue)