Set-AzureRmApplicationGatewayBackendHttpSettings
アプリケーション ゲートウェイのバックエンド HTTP 設定を更新します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureRmApplicationGatewayBackendHttpSettings
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-Port <Int32>
-Protocol <String>
-CookieBasedAffinity <String>
[-RequestTimeout <Int32>]
[-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
[-ProbeId <String>]
[-Probe <PSApplicationGatewayProbe>]
[-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
[-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
[-PickHostNameFromBackendAddress]
[-HostName <String>]
[-AffinityCookieName <String>]
[-Path <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Set-AzureRmApplicationGatewayBackendHttp設定 コマンドレットは、Azure アプリケーション ゲートウェイのバックエンド ハイパーテキスト転送プロトコル (HTTP) 設定を更新します。 バックエンド HTTP 設定は、プール内のすべてのバックエンド サーバーに適用されます。
例
例 1: アプリケーション ゲートウェイのバックエンド HTTP 設定を更新する
PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayBackendHttpSettings -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 2 番目のコマンドは、ポート 88 (HTTP プロトコル) を使用するように $AppGw 変数内のアプリケーション ゲートウェイの HTTP 設定を更新し、Cookie ベースのアフィニティを有効にします。
パラメーター
-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: | List<T>[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: | 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: | List<T>[PSApplicationGatewayTrustedRootCertificate] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
パラメーター: ApplicationGateway (ByValue)