Set-AzNetworkInterfaceIpConfig
ネットワーク インターフェイスの IP 構成を更新します。
構文
Set-AzNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
[-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
[-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
[-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
[-GatewayLoadBalancerId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <String[]>]
[-LoadBalancerInboundNatRuleId <String[]>]
[-ApplicationGatewayBackendAddressPoolId <String[]>]
[-ApplicationSecurityGroupId <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Set-AzNetworkInterfaceIpConfig コマンドレットは、ネットワーク インターフェイスの IP 構成を更新します。
例
例 1: IP 構成の IP アドレスの変更
$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary
$nic | Set-AzNetworkInterface
最初の 2 つのコマンドは、myvnet と呼ばれる仮想ネットワークと mysubnet というサブネットを取得し、それぞれ$vnet変数と$subnetに格納します。 3 番目のコマンドは、更新する必要がある IP 構成に関連付けられているネットワーク インターフェイス nic1 を取得します。 3 番目のコマンドは、プライマリ IP 構成 ipconfig1 のプライベート IP アドレスを 10.0.0.11 に設定します。 最後に、最後のコマンドは、変更が正常に行われていることを確認するネットワーク インターフェイスを更新します。
例 2: IP 構成とアプリケーション セキュリティ グループの関連付け
$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg
$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary
$nic | Set-AzNetworkInterface
この例では、$asg変数にアプリケーション セキュリティ グループへの参照が含まれています。 4 番目のコマンドは、更新する必要がある IP 構成に関連付けられているネットワーク インターフェイス nic1 を取得します。 Set-AzNetworkInterfaceIpConfig は、プライマリ IP 構成 ipconfig1 のプライベート IP アドレスを 10.0.0.11 に設定し、取得したアプリケーション セキュリティ グループとの関連付けを作成します。 最後に、最後のコマンドは、変更が正常に行われていることを確認するネットワーク インターフェイスを更新します。
例 3: IP 構成とアプリケーション ゲートウェイ バックエンド アドレス プールの関連付けを解除する
$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null
$nic | Set-AzNetworkInterface
Set-AzNetworkInterfaceIpConfig は、IP 構成 ipconfig1 のアプリケーション ゲートウェイ バックエンド アドレス プールを null に設定し、ネットワーク インターフェイスとの関連付けを解除します。 最後に、最後のコマンドは、変更が正常に行われていることを確認するネットワーク インターフェイスを更新します。
パラメーター
-ApplicationGatewayBackendAddressPool
このネットワーク インターフェイス IP 構成が属するアプリケーション ゲートウェイ バックエンド アドレス プール参照のコレクションを指定します。
型: | PSApplicationGatewayBackendAddressPool[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ApplicationGatewayBackendAddressPoolId
このネットワーク インターフェイス IP 構成が属するアプリケーション ゲートウェイ バックエンド アドレス プール参照のコレクションを指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ApplicationSecurityGroup
このネットワーク インターフェイス IP 構成が属するアプリケーション セキュリティ グループ参照のコレクションを指定します。
型: | PSApplicationSecurityGroup[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ApplicationSecurityGroupId
このネットワーク インターフェイス IP 構成が属するアプリケーション セキュリティ グループ参照のコレクションを指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GatewayLoadBalancerId
ゲートウェイ ロード バランサー プロバイダーのフロントエンド IP 構成の ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LoadBalancerBackendAddressPool
このネットワーク インターフェイス IP 構成が属するロード バランサー バックエンド アドレス プール参照のコレクションを指定します。
型: | PSBackendAddressPool[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LoadBalancerBackendAddressPoolId
このネットワーク インターフェイス IP 構成が属するロード バランサー バックエンド アドレス プール参照のコレクションを指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LoadBalancerInboundNatRule
このネットワーク インターフェイス IP 構成が属するロード バランサーの受信ネットワーク アドレス変換 (NAT) 規則参照のコレクションを指定します。
型: | PSInboundNatRule[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-LoadBalancerInboundNatRuleId
このネットワーク インターフェイス IP 構成が属するロード バランサーの受信 NAT 規則参照のコレクションを指定します。
型: | 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 |
入力
String[]
PSApplicationGatewayBackendAddressPool[]
出力
メモ
- キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, ネットワーク, ネットワーク
関連リンク
Azure PowerShell