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[]>

在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。

-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>

指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0，那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目，计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet，而不适用于会话或计算机。

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

输入

输入类型是指可通过管道传送给 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 所发出对象的类型。

示例

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