Add-AzureRmApplicationGatewayFrontendIPConfig
フロントエンド IP 構成をアプリケーション ゲートウェイに追加します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzureRmApplicationGatewayFrontendIPConfig コマンドレットは、フロントエンド IP 構成をアプリケーション ゲートウェイに追加します。 アプリケーション ゲートウェイは、次の 2 種類のフロントエンド IP 構成をサポートします。
- パブリック IP アドレス
- 内部負荷分散 (ILB) を使用するプライベート IP アドレスアプリケーション ゲートウェイは、最大で 1 つのパブリック IP と 1 つのプライベート IP を持つことができます。 パブリック IP アドレスとプライベート IP アドレスを別のフロントエンド IP として追加します。
例
例 1: フロントエンド IP アドレスとしてパブリック IP を追加する
PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp
最初のコマンドは、パブリック IP アドレス オブジェクトを作成し、$PublicIp変数に格納します。 2 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 3 番目のコマンドは、$PublicIpに格納されているアドレスを使用して、$AppGwのゲートウェイに対して FrontEndIp01 という名前のフロントエンド IP 構成を追加します。
例 2: フロントエンド IP アドレスとして静的プライベート IP を追加する
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1
最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。 2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。 3 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 4 番目のコマンドは、2 番目のコマンドの$Subnetとプライベート IP アドレス 10.0.1.1 を使用して、FrontendIP02 という名前のフロントエンド IP 構成を追加します。
例 3: フロントエンド IP アドレスとして動的プライベート IP を追加する
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet
最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。 2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。 3 番目のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 4 番目のコマンドは、2 番目のコマンドの$Subnetを使用して、FrontendIP02 という名前のフロントエンド IP 構成を追加します。
パラメーター
-ApplicationGateway
このコマンドレットがフロントエンド IP 構成を追加するアプリケーション ゲートウェイを指定します。
型: | PSApplicationGateway |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
追加するフロントエンド IP 構成の名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrivateIPAddress
アプリケーション ゲートウェイのフロントエンド IP として追加するプライベート IP アドレスを指定します。 指定した場合、この IP はサブネットから静的に割り当てられます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PublicIPAddress
このコマンドレットがアプリケーション ゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスを指定します。
型: | PSPublicIpAddress |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PublicIPAddressId
このコマンドレットがアプリケーション ゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Subnet
このコマンドレットがフロントエンド IP 構成として追加するサブネットを指定します。 このパラメーターを指定すると、アプリケーション ゲートウェイがプライベート IP ベースの構成をサポートすることを意味します。 PrivateIPAddress パラメーターが指定されている場合は、このサブネットに属している必要があります。 PrivateIPAddressが指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーション ゲートウェイのフロントエンド IP アドレスとして動的に取得されます。
型: | PSSubnet |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SubnetId
このコマンドレットがフロントエンド IP 構成として追加するサブネット ID を指定します。 サブネットを渡すことは、プライベート IP を意味します。 PrivateIPAddresss パラメーターが指定されている場合は、このサブネットに属している必要があります。 それ以外の場合、このサブネットの IP の 1 つが、アプリケーション ゲートウェイのフロントエンド IP として動的に取得されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
パラメーター: ApplicationGateway (ByValue)