Add-AzureRmApplicationGatewayFrontendIPConfig

リファレンス

モジュール:: AzureRM.Network

フロントエンド 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 構成を追加するアプリケーションゲートウェイを指定します。

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

追加するフロントエンド IP 構成の名前を指定します。

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

-PrivateIPAddress

アプリケーションゲートウェイのフロントエンド IP として追加するプライベート IP アドレスを指定します。指定した場合、この IP はサブネットから静的に割り当てられます。

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

-PublicIPAddress

このコマンドレットがアプリケーションゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスを指定します。

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

-PublicIPAddressId

このコマンドレットがアプリケーションゲートウェイのフロントエンド IP アドレスとして追加するパブリック IP アドレスの ID を指定します。

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

-Subnet

このコマンドレットがフロントエンド IP 構成として追加するサブネットを指定します。このパラメーターを指定すると、アプリケーションゲートウェイがプライベート IP ベースの構成をサポートすることを意味します。 PrivateIPAddress パラメーターが指定されている場合は、このサブネットに属している必要があります。 PrivateIPAddress が指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーションゲートウェイのフロントエンド IP アドレスとして動的に取得されます。

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

-SubnetId

このコマンドレットがフロントエンド IP 構成として追加するサブネット ID を指定します。サブネットを渡すことは、プライベート IP を意味します。 PrivateIPAddresss パラメーターが指定されている場合は、このサブネットに属している必要があります。それ以外の場合、このサブネットの IP の 1 つが、アプリケーションゲートウェイのフロントエンド IP として動的に取得されます。

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

入力

PSApplicationGateway

パラメーター: ApplicationGateway (ByValue)

出力