Add-AzApplicationGatewayBackendHttpSetting

バックエンド HTTP 設定をアプリケーション ゲートウェイに追加します。

構文

Add-AzApplicationGatewayBackendHttpSetting
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   -Port <Int32>
   -Protocol <String>
   -CookieBasedAffinity <String>
   [-RequestTimeout <Int32>]
   [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
   [-ProbeId <String>]
   [-Probe <PSApplicationGatewayProbe>]
   [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
   [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
   [-PickHostNameFromBackendAddress]
   [-HostName <String>]
   [-AffinityCookieName <String>]
   [-Path <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Add-AzApplicationGatewayBackendHttpSetting コマンドレットは、バックエンド HTTP 設定をアプリケーション ゲートウェイに追加します。 バックエンド HTTP 設定は、プール内のすべてのバックエンド サーバーに適用されます。

例 1: バックエンド HTTP 設定をアプリケーション ゲートウェイに追加する

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayBackendHttpSetting -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "HTTP" -CookieBasedAffinity "Disabled"

最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。2 番目のコマンドは、バックエンドの HTTP 設定をアプリケーション ゲートウェイに追加し、ポートを 88 に設定し、プロトコルを HTTP に設定し、Setting02 という名前を付けます。

例 2

バックエンド HTTP 設定をアプリケーション ゲートウェイに追加します。 (自動生成)

Add-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -PickHostNameFromBackendAddress -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol http -RequestTimeout <Int32>

パラメーター

-AffinityCookieName

アフィニティ Cookie に使用する Cookie 名

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

-ApplicationGateway

このコマンドレットが設定を追加するアプリケーション ゲートウェイの名前を指定します。

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

-AuthenticationCertificates

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

Type:PSApplicationGatewayAuthenticationCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionDraining

バックエンド http 設定リソースの接続ドレイン。

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

-CookieBasedAffinity

バックエンド サーバー プールに対して Cookie ベースのアフィニティを有効または無効にするかどうかを指定します。 このパラメーターに使用できる値は、Disabled、Enabled です。

Type:String
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-HostName

バックエンド サーバーに送信されるホスト ヘッダーを設定します。

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

-Name

このコマンドレットが追加するバックエンド HTTP 設定の名前を指定します。

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

-Path

すべての HTTP 要求のプレフィックスとして使用する必要があるパス。 このパラメーターに値が指定されていない場合、パスにはプレフィックスは付けなくなります。

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

-PickHostNameFromBackendAddress

バックエンド サーバーのホスト名からホスト ヘッダーを選択する必要がある場合にフラグを設定します。

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

-Port

バックエンド サーバー プールのポートを指定します。

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

-Probe

バックエンド サーバーに関連付けるプローブを指定します。

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

-ProbeId

バックエンド サーバーに関連付けるプローブの ID を指定します。

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

-Protocol

アプリケーション ゲートウェイとバックエンド サーバー間の通信用のプロトコルを指定します。 このパラメーターに使用できる値は、Http と Https です。

Type:String
Accepted values:Http, Https
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequestTimeout

要求のタイムアウト値を指定します。

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

-TrustedRootCertificate

Application Gateway の信頼されたルート証明書

Type:PSApplicationGatewayTrustedRootCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSApplicationGateway

出力

PSApplicationGateway