次の方法で共有

New-AzureRmApplicationGateway

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

アプリケーション ゲートウェイを作成します。

警告

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

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

構文

New-AzureRmApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration]>
   [-SslCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate]>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-FrontendIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration]>]
   -FrontendPorts <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort]>
   [-Probes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe]>]
   -BackendAddressPools <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>
   -BackendHttpSettingsCollection <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings]>
   -HttpListeners <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener]>
   [-UrlPathMaps <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap]>]
   -RequestRoutingRules <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule]>
   [-RedirectConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzureRmApplicationGateway コマンドレットは、Azure アプリケーション ゲートウェイを作成します。 アプリケーション ゲートウェイには、次のものが必要です。

  • リソース グループ。
  • 仮想ネットワーク。
  • バックエンド サーバーの IP アドレスを含むバックエンド サーバー プール。
  • バックエンド サーバー プールの設定。 各プールには、プール内のすべてのサーバーに適用されるポート、プロトコル、Cookie ベースのアフィニティなどの設定があります。
  • フロントエンド IP アドレス。これは、アプリケーション ゲートウェイで開かれた IP アドレスです。 フロントエンド IP アドレスには、パブリック IP アドレスまたは内部 IP アドレスを指定できます。
  • フロントエンド ポート。これは、アプリケーション ゲートウェイで開かれたパブリック ポートです。 これらのポートにヒットしたトラフィックは、バックエンド サーバーにリダイレクトされます。
  • リスナーとバックエンド サーバー プールをバインドする要求ルーティング規則。 ルールでは、特定のリスナーにヒットしたときにトラフィックを転送するバックエンド サーバー プールを定義します。 リスナーには、フロントエンド ポート、フロントエンド IP アドレス、プロトコル (HTTP または HTTPS)、Secure Sockets Layer (SSL) 証明書名 (SSL オフロードを構成している場合) があります。

例

例 1: アプリケーション ゲートウェイを作成する

PS C:\> $ResourceGroup = New-AzureRmResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
PS C:\> $Subnet = New-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
PS C:\> $VNet = New-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
PS C:\> $VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet 
PS C:\> $GatewayIPconfig = New-AzureRmApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
PS C:\> $Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
PS C:\> $PoolSetting = New-AzureRmApplicationGatewayBackendHttpSettings -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $FrontEndPort = New-AzureRmApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
PS C:\> $PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
PS C:\> $FrontEndIpConfig = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
PS C:\> $Listener = New-AzureRmApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
PS C:\> $Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
PS C:\> $Sku = New-AzureRmApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
PS C:\> $Gateway = New-AzureRmApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

次の例では、最初にリソース グループと仮想ネットワークを作成して、アプリケーション ゲートウェイを作成します。

  • バックエンド サーバー プール
  • バックエンド サーバー プールの設定
  • フロントエンド ポート
  • フロントエンド IP アドレス
  • 要求ルーティング規則 次の 4 つのコマンドは、仮想ネットワークを作成します。 最初のコマンドは、サブネット構成を作成します。 2 番目のコマンドは、仮想ネットワークを作成します。 3 番目のコマンドはサブネット構成を検証し、4 番目のコマンドは仮想ネットワークが正常に作成されたことを確認します。 次のコマンドは、アプリケーション ゲートウェイを作成します。 最初のコマンドは、前に作成したサブネットの GatewayIp01 という名前の IP 構成を作成します。 2 番目のコマンドは、バックエンド IP アドレスの一覧を含む Pool01 という名前のバックエンド サーバー プールを作成し、プールを $Pool 変数に格納します。 3 番目のコマンドは、バックエンド サーバー プールの設定を作成し、$PoolSetting変数に設定を格納します。 4 番目のコマンドは、ポート 80 にフロントエンド ポートを作成し、FrontEndPort01 という名前を付け、$FrontEndPort変数にポートを格納します。 5 番目のコマンドは、New-AzureRmPublicIpAddress を使用してパブリック IP アドレスを作成します。 6 番目のコマンドは、$PublicIpを使用してフロントエンド IP 構成を作成し、FrontEndPortConfig01 という名前を付け、$FrontEndIpConfig変数に格納します。 7 番目のコマンドは、前に作成した$FrontEndIpConfig $FrontEndPortを使用してリスナーを作成します。 8 番目のコマンドは、リスナーのルールを作成します。 9 番目のコマンドは SKU を設定します。 10 番目のコマンドは、前のコマンドで設定したオブジェクトを使用してゲートウェイを作成します。

パラメーター

-AsJob

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AuthenticationCertificates

アプリケーション ゲートウェイの認証証明書を指定します。

型:List<T>[PSApplicationGatewayAuthenticationCertificate]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-AutoscaleConfiguration

自動スケールの構成

型:PSApplicationGatewayAutoscaleConfiguration
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-BackendAddressPools

アプリケーション ゲートウェイのバックエンド アドレス プールの一覧を指定します。

型:List<T>[PSApplicationGatewayBackendAddressPool]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-BackendHttpSettingsCollection

アプリケーション ゲートウェイのバックエンド HTTP 設定の一覧を指定します。

型:List<T>[PSApplicationGatewayBackendHttpSettings]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableFIPS

FIPS が有効かどうか。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableHttp2

HTTP2 が有効かどうか。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FrontendIPConfigurations

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

型:List<T>[PSApplicationGatewayFrontendIPConfiguration]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-FrontendPorts

アプリケーション ゲートウェイのフロントエンド ポートの一覧を指定します。

型:List<T>[PSApplicationGatewayFrontendPort]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-GatewayIPConfigurations

アプリケーション ゲートウェイの IP 構成の一覧を指定します。

型:List<T>[PSApplicationGatewayIPConfiguration]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-HttpListeners

アプリケーション ゲートウェイの HTTP リスナーの一覧を指定します。

型:List<T>[PSApplicationGatewayHttpListener]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Location

アプリケーション ゲートウェイを作成するリージョンを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

アプリケーション ゲートウェイの名前を指定します。

型:String
Aliases:ResourceName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Probes

アプリケーション ゲートウェイのプローブを指定します。

型:List<T>[PSApplicationGatewayProbe]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RedirectConfigurations

リダイレクト構成の一覧

型:List<T>[PSApplicationGatewayRedirectConfiguration]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RequestRoutingRules

アプリケーション ゲートウェイの要求ルーティング規則の一覧を指定します。

型:List<T>[PSApplicationGatewayRequestRoutingRule]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

アプリケーション ゲートウェイを作成するリソース グループの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Sku

アプリケーション ゲートウェイの在庫保持ユニット (SKU) を指定します。

型:PSApplicationGatewaySku
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SslCertificates

アプリケーション ゲートウェイの Secure Sockets Layer (SSL) 証明書の一覧を指定します。

型:List<T>[PSApplicationGatewaySslCertificate]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SslPolicy

アプリケーション ゲートウェイの SSL ポリシーを指定します。

型:PSApplicationGatewaySslPolicy
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Tag

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TrustedRootCertificate

信頼されたルート証明書の一覧

型:List<T>[PSApplicationGatewayTrustedRootCertificate]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-UrlPathMaps

アプリケーション ゲートウェイの URL パス マップを指定します。

型:List<T>[PSApplicationGatewayUrlPathMap]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WebApplicationFirewallConfiguration

Web アプリケーション ファイアウォール (WAF) の構成を指定します。 Get-AzureRmApplicationGatewayWebApplicationFirewallConfiguration コマンドレットを使用して WAF を取得できます。

型:PSApplicationGatewayWebApplicationFirewallConfiguration
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Zone

アプリケーション ゲートウェイの取得場所を示す可用性ゾーンの一覧。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

PSApplicationGatewaySku

PSApplicationGatewaySslPolicy

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

PSApplicationGatewayWebApplicationFirewallConfiguration

Hashtable

出力

PSApplicationGateway