Set-AzApplicationGatewayBackendHttpSetting
アプリケーション ゲートウェイのバックエンド 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 名
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ApplicationGateway
このコマンドレットがバックエンド HTTP 設定を関連付けるアプリケーション ゲートウェイ オブジェクトを指定します。
型: | PSApplicationGateway |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-AuthenticationCertificates
アプリケーション ゲートウェイの認証証明書を指定します。
型: | PSApplicationGatewayAuthenticationCertificate[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ConnectionDraining
バックエンド http 設定リソースの接続ドレイン。
型: | PSApplicationGatewayConnectionDraining |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CookieBasedAffinity
バックエンド サーバー プールに対して Cookie ベースのアフィニティを有効または無効にするかどうかを指定します。 このパラメーターに使用できる値は、Disabled または Enabled です。
型: | String |
指定可能な値: | Enabled, Disabled |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-HostName
バックエンド サーバーに送信されるホスト ヘッダーを設定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
バックエンド HTTP 設定オブジェクトの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
すべての HTTP 要求のプレフィックスとして使用する必要があるパス。 このパラメーターに値が指定されていない場合、パスにはプレフィックスは付けなくなります。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PickHostNameFromBackendAddress
バックエンド サーバーのホスト名からホスト ヘッダーを選択する必要がある場合にフラグを設定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Port
バックエンド サーバー プール内の各サーバーに使用するポートを指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Probe
バックエンド HTTP 設定に関連付けるプローブを指定します。
型: | PSApplicationGatewayProbe |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProbeId
バックエンド HTTP 設定に関連付けるプローブの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Protocol
アプリケーション ゲートウェイとバックエンド サーバー間の通信に使用するプロトコルを指定します。 このパラメーターに使用できる値は、Http と Https です。 このパラメーターでは、大文字と小文字が区別されます。
型: | String |
指定可能な値: | Http, Https |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RequestTimeout
要求のタイムアウト値を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TrustedRootCertificate
Application Gateway の信頼されたルート証明書
型: | PSApplicationGatewayTrustedRootCertificate[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell