Set-AzApplicationGatewayBackendHttpSetting
アプリケーション ゲートウェイのバックエンド HTTP 設定を更新します。
構文
Default (既定)
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 設定を更新します。 (autogenerated)
Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol https -RequestTimeout <Int32>
パラメーター
-AffinityCookieName
アフィニティ Cookie に使用する Cookie 名
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ApplicationGateway
このコマンドレットがバックエンド HTTP 設定を関連付けるアプリケーション ゲートウェイ オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-AuthenticationCertificates
アプリケーション ゲートウェイの認証証明書を指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConnectionDraining
バックエンド http 設定リソースの接続ドレイン。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-CookieBasedAffinity
バックエンド サーバー プールに対して Cookie ベースのアフィニティを有効または無効にするかどうかを指定します。
このパラメーターに使用できる値は、Disabled または Enabled です。
パラメーターのプロパティ
型: | String
|
規定値: | None |
指定可能な値: | Enabled, Disabled |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
型: | IAzureContextContainer
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-HostName
バックエンド サーバーに送信されるホスト ヘッダーを設定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Name
バックエンド HTTP 設定オブジェクトの名前を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Path
すべての HTTP 要求のプレフィックスとして使用する必要があるパス。
このパラメーターに値が指定されていない場合、パスにはプレフィックスは付けなくなります。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PickHostNameFromBackendAddress
バックエンド サーバーのホスト名からホスト ヘッダーを選択する必要がある場合にフラグを設定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Port
バックエンド サーバー プール内の各サーバーに使用するポートを指定します。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Probe
バックエンド HTTP 設定に関連付けるプローブを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ProbeId
バックエンド HTTP 設定に関連付けるプローブの ID を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Protocol
アプリケーション ゲートウェイとバックエンド サーバー間の通信に使用するプロトコルを指定します。
このパラメーターに使用できる値は、Http と Https です。
このパラメーターでは、大文字と小文字が区別されます。
パラメーターのプロパティ
型: | String
|
規定値: | None |
指定可能な値: | Http, Https |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RequestTimeout
要求のタイムアウト値を指定します。
パラメーターのプロパティ
型: | Int32
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-TrustedRootCertificate
Application Gateway の信頼されたルート証明書
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力