Set-WebApplicationProxyConfiguration

Set-WebApplicationProxyConfiguration

Modifies the configuration settings of a Web 應用程式 Proxy 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 應用程式 Proxy server, including the Active Directory Federation Services (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 應用程式 Proxy. The Web 應用程式 Proxy Configuration Wizard populates this setting, and there is no requirement that you manually change it.

-ADFSWebApplicationProxyRelyingPartyUri<Uri>

Specifies the URI for the Web 應用程式 Proxy server.

-AsJob

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

-ConfigurationChangesPollingIntervalSec<UInt32>

Specifies the time interval, in seconds, that elapses before the Web 應用程式 Proxy servers query a federation server for configuration changes.

-ConnectedServersName<String[]>

Specifies an array of Web 應用程式 Proxy 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 應用程式 Proxy to query the federation server every 300 seconds for configuration changes.

PS C:\> Set-WebApplicationProxyConfiguration -ConfigurationChangesPollingIntervalSec 300

相關主題

Get-WebApplicationProxyConfiguration