Set-WebApplicationProxyConfiguration

Set-WebApplicationProxyConfiguration

Modifies the configuration settings of a Webanwendungsproxy server.

Syntax

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

Detaillierte Beschreibung

The Set-WebApplicationProxyConfiguration cmdlet modifies the configuration settings of a Webanwendungsproxy server, including the Active Directory-Verbunddienste (Active Directory Federation Services, AD FS) URL, the token signing certificate, and the edge server URI.

Parameter

-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 Webanwendungsproxy. The Webanwendungsproxy Configuration Wizard populates this setting, and there is no requirement that you manually change it.

-ADFSWebApplicationProxyRelyingPartyUri<Uri>

Specifies the URI for the Webanwendungsproxy server.

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ConfigurationChangesPollingIntervalSec<UInt32>

Specifies the time interval, in seconds, that elapses before the Webanwendungsproxy servers query a federation server for configuration changes.

-ConnectedServersName<String[]>

Specifies an array of Webanwendungsproxy 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>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Beispiele

Example 1: Modify the proxy to check for configuration changes

This command modifies the Webanwendungsproxy to query the federation server every 300 seconds for configuration changes.

PS C:\> Set-WebApplicationProxyConfiguration -ConfigurationChangesPollingIntervalSec 300

Verwandte Themen

Get-WebApplicationProxyConfiguration