Set-WebApplicationProxyConfiguration

Set-WebApplicationProxyConfiguration

Modifies the configuration settings of a Web アプリケーション プロキシ server.

構文

Parameter Set: Set1
Set-WebApplicationProxyConfiguration [-ADFSTokenSigningCertificatePublicKey <String> ] [-ADFSUrl <Uri> ] [-ADFSWebApplicationProxyRelyingPartyUri <Uri> ] [-AsJob] [-CimSession <CimSession[]> ] [-ConfigurationChangesPollingIntervalSec <UInt32> ] [-ConnectedServersName <String[]> ] [-OAuthAuthenticationURL <Uri> ] [-RegenerateAccessCookiesEncryptionKey] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

詳細説明

The Set-WebApplicationProxyConfiguration cmdlet modifies the configuration settings of a Web アプリケーション プロキシ server, including the Active Directory フェデレーション サービス (AD FS) URL, the token signing certificate, and the edge server URI.

パラメーター

-ADFSTokenSigningCertificatePublicKey<String>

Specifies the thumbprint of the certificate that the federation server uses to sign the edge token. The thumbprint is the SHA-1 hash of the certificate and consists of 40 hexadecimal characters. Specify this parameter only when the AD FS token signing certificate changes.

-ADFSUrl<Uri>

Specifies the URL for the federation server used by the Web アプリケーション プロキシ. The Web アプリケーション プロキシ Configuration Wizard populates this setting, and there is no requirement that you manually change it.

-ADFSWebApplicationProxyRelyingPartyUri<Uri>

Specifies the URI for the Web アプリケーション プロキシ server.

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-ConfigurationChangesPollingIntervalSec<UInt32>

Specifies the time interval, in seconds, that elapses before the Web アプリケーション プロキシ servers query a federation server for configuration changes.

-ConnectedServersName<String[]>

Specifies an array of Web アプリケーション プロキシ servers that are connected to a federation server.

-OAuthAuthenticationURL<Uri>

Specifies the URL of the federation server that performs Open Authorization (OAuth) authentication when end users connect to a published web application using a Windows Store app.

-RegenerateAccessCookiesEncryptionKey

Specifies whether to create a new encryption key to be used by Web Application Proxy servers to encrypt proxy cookies. All Web Application Proxy servers use the encryption key to validate the access cookie, even if the cookie was issued by another Web Application Proxy server.

You should specify this parameter whenever you want to change the encryption key that is used to encrypt the proxy cookies.

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Modify the proxy to check for configuration changes

This command modifies the Web アプリケーション プロキシ to query the federation server every 300 seconds for configuration changes.

PS C:\> Set-WebApplicationProxyConfiguration -ConfigurationChangesPollingIntervalSec 300

関連トピック

Get-WebApplicationProxyConfiguration