次の方法で共有


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 設定を関連付けるアプリケーション ゲートウェイ オブジェクトを指定します。

パラメーターのプロパティ

型:PSApplicationGateway
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AuthenticationCertificates

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

パラメーターのプロパティ

型:

PSApplicationGatewayAuthenticationCertificate[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectionDraining

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

パラメーターのプロパティ

型:PSApplicationGatewayConnectionDraining
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Port

バックエンド サーバー プール内の各サーバーに使用するポートを指定します。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Probe

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

パラメーターのプロパティ

型:PSApplicationGatewayProbe
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(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 の信頼されたルート証明書

パラメーターのプロパティ

型:

PSApplicationGatewayTrustedRootCertificate[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

PSApplicationGateway

出力

PSApplicationGateway