New-AzureRmApplicationGatewayFrontendIPConfig

アプリケーション ゲートウェイのフロントエンド IP 構成を作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmApplicationGatewayFrontendIPConfig
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmApplicationGatewayFrontendIPConfig
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzureRmApplicationGatewayFrontendIPConfig コマンドレットは、Azure アプリケーション ゲートウェイのフロントエンド 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:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP

最初のコマンドは、パブリック IP リソース オブジェクトを作成し、$PublicIP変数に格納します。 2 番目のコマンドでは、$PublicIPを使用して FrontEndIP01 という名前の新しいフロントエンド IP 構成を作成し、$FrontEnd変数に格納します。

例 2: フロントエンド IP アドレスとして静的プライベート IP を作成する

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。 2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。 3 番目のコマンドは、2 番目のコマンドの$Subnetとプライベート IP アドレス 10.0.1.1 を使用して FrontEndIP02 という名前のフロントエンド IP 構成を作成し、それを$FrontEnd変数に格納します。

例 3: フロントエンド IP アドレスとして動的プライベート IP を作成する

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -Subnet $Subnet

最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する VNet01 という名前の仮想ネットワークを取得し、$VNet変数に格納します。 2 番目のコマンドは、最初のコマンドから $VNet を使用して Subnet01 という名前のサブネット構成を取得し、$Subnet変数に格納します。 3 番目のコマンドは、2 番目のコマンドの$Subnetを使用して FrontEndIP03 という名前のフロントエンド IP 構成を作成し、$FrontEnd変数に格納します。

パラメーター

-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 アドレスを使用することを意味します。 PrivateIPAddresss パラメーターが指定されている場合は、このパラメーターで指定されたサブネットに属している必要があります。 PrivateIPAddress が指定されていない場合、このサブネットの IP アドレスの 1 つが、アプリケーション ゲートウェイのフロントエンド IP アドレスとして動的に取得されます。

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

-SubnetId

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

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

入力

None

出力

PSApplicationGatewayFrontendIPConfiguration