Set-AzApplicationGatewayBackendHttpSetting

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

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

構文

Set-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>]

説明

Set-AzApplicationGatewayBackendHttpSetting コマンドレットは、Azure アプリケーション ゲートウェイのバックエンドハイパーテキスト転送プロトコル (HTTP) 設定を更新します。 バックエンド HTTP 設定は、プール内のすべてのバックエンド サーバーに適用されます。

例

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

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

最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 2 番目のコマンドは、ポート 88 (HTTP プロトコル) を使用するように $AppGw 変数内のアプリケーション ゲートウェイの HTTP 設定を更新し、Cookie ベースのアフィニティを有効にします。

例 2

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

Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol https -RequestTimeout <Int32>

パラメーター

-AffinityCookieName

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

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

-ApplicationGateway

このコマンドレットがバックエンド HTTP 設定を関連付けるアプリケーション ゲートウェイ オブジェクトを指定します。

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

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

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

-ProbeId

バックエンド HTTP 設定に関連付けるプローブの 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