Set-AzNetworkInterface

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

ネットワーク インターフェイスを更新します。

構文

Set-AzNetworkInterface
   -NetworkInterface <PSNetworkInterface>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Set-AzNetworkInterface は、ネットワーク インターフェイスを更新します。

例

例 1: ネットワーク インターフェイスを構成する

$Nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzNetworkInterface -NetworkInterface $Nic

この例では、ネットワーク インターフェイスを構成します。 最初のコマンドは、リソース グループ ResourceGroup1 の NetworkInterface1 という名前のネットワーク インターフェイスを取得します。 2 番目のコマンドは、IP 構成のプライベート IP アドレスを設定します。 3 番目のコマンドは、プライベート IP 割り当て方法を Static に設定します。 4 番目のコマンドは、ネットワーク インターフェイスにタグを設定します。 5 番目のコマンドは、$Nic変数に格納されている情報を使用して、ネットワーク インターフェイスを設定します。

例 2: ネットワーク インターフェイスの DNS 設定を変更する

$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface

最初のコマンドは、リソース グループ ResourceGroup1 内に存在する NetworkInterface1 という名前のネットワーク インターフェイスを取得します。 2 番目のコマンドは、このインターフェイスに DNS サーバー 192.168.1.100 を追加します。 3 番目のコマンドは、これらの変更をネットワーク インターフェイスに適用します。 DNS サーバーを削除するには、上記のコマンドに従いますが、置き換えてください。Add" with ".2 番目のコマンドで "Remove" を選択します。

例 3: ネットワーク インターフェイスで IP 転送を有効にする

$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzNetworkInterface

最初のコマンドは、NetworkInterface1 という名前の既存のネットワーク インターフェイスを取得し、$nic変数に格納します。 2 番目のコマンドは、IP 転送の値を true に変更します。 最後に、3 番目のコマンドは、ネットワーク インターフェイスに変更を適用します。 ネットワーク インターフェイスで IP 転送を無効にするには、サンプルの例に従いますが、必ず 2 番目のコマンドを "$nic" に変更してください。EnableIPForwarding = 0"

例 4: ネットワーク インターフェイスのサブネットを変更する

$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzNetworkInterface

最初のコマンドは、ネットワーク インターフェイス NetworkInterface1 を取得し、$nic変数に格納します。 2 番目のコマンドは、ネットワーク インターフェイスが関連付けられるサブネットに関連付けられている仮想ネットワークを取得します。 2 番目のコマンドは、サブネットを取得し、$subnet 2 変数に格納します。 3 番目のコマンドは、ネットワーク インターフェイスのプライマリ プライベート IP アドレスを新しいサブネットに関連付けました。 最後に、最後のコマンドによって、これらの変更がネットワーク インターフェイスに適用されました。

Note

IP 構成は、サブネットを変更する前に動的である必要があります。 静的 IP 構成がある場合は、続行する前に動的に変更します。

Note

ネットワーク インターフェイスに複数の IP 構成がある場合は、最終的な Set-AzNetworkInterface コマンドを実行する前に、これらすべての IP 構成に対して 4 番目のコマンドを実行する必要があります。 これは、4 番目のコマンドと同様に実行できますが、"0" を適切な数に置き換えます。 ネットワーク インターフェイスに N 個の IP 構成がある場合は、これらのコマンドの N-1 が存在する必要があります。

例 5: ネットワーク セキュリティ グループをネットワーク インターフェイスに関連付ける/関連付けを解除する

$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzNetworkInterface

最初のコマンドは、NetworkInterface1 という名前の既存のネットワーク インターフェイスを取得し、$nic変数に格納します。 2 番目のコマンドは、MyNSG という名前の既存のネットワーク セキュリティ グループを取得し、$nsg変数に格納します。 3 番目のコマンドは、$nicに$nsgを割り当てます。 最後に、4 番目のコマンドは、ネットワーク インターフェイスに変更を適用します。 ネットワーク インターフェイスからネットワーク セキュリティ グループの関連付けを解除するには、3 番目のコマンドの$nsgを$nullに置き換えます。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-NetworkInterface

ネットワーク インターフェイスを設定する必要がある状態を表すネットワーク インターフェイス オブジェクトを指定します。

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

入力

PSNetworkInterface

出力

PSNetworkInterface