Set-CsProxyConfiguration

Syntax

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Microsoft Lync Server 2010 ermöglicht die Verwaltung von Proxyservern mithilfe entsprechender Konfigurationseinstellungen. Diese Einstellungen, die sowohl auf globaler Ebene als auch auf Dienstebene angewendet werden können (wenn auch nur für den Edgeserver und den Registrierungsdienst), ermöglichen u. a. die Steuerung von Authentifizierungsprotokollen, die von Clientendpunkten verwendet werden können, und die Entscheidung, ob die Daten eingehender und ausgehender Proxyserververbindungen komprimiert werden. Während der Installation von Lync Server 2010 wird automatisch eine globale Auflistung von Konfigurationseinstellungen für Proxyserver erstellt. Wie erwähnt, können Sie auch zusätzliche Auflistungen auf Dienstebene erstellen.

Mit dem Cmdlet Set-CsProxyConfiguration können Sie die Eigenschaftswerte einer vorhandenen Auflistung von Konfigurationseinstellungen für Proxyserver ändern.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsProxyConfiguration lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsProxyConfiguration"}

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings-Objekt. Set-CsProxyConfiguration akzeptiert weitergeleitete Instanzen des Objekts für Proxyeinstellungen.

Rückgabetypen

Set-CsProxyConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings" konfiguriert.

Beispiel

-------------------------- Beispiel 1 --------------------------

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

In Beispiel 1 werden die Proxykonfigurationseinstellungen mit dem Identitätswert "service:EdgeServer:atl-edge-001.litwareinc.com" so abgeändert, dass sie eine Serverkomprimierung zulassen. Hierzu wird Set-CsProxyConfiguration mit dem Parameter "AcceptServerCompression " aufgerufen und der Parameterwert auf "True" festgelegt.

-------------------------- Beispiel 2 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

Mit dem vorstehenden Befehl werden alle Proxykonfigurationseinstellungen ermittelt, die eine Serverkomprimierung zulassen. Anschließend werden diese Einstellungen so abgeändert, dass sie auch eine Clientkomprimierung zulassen. Dazu ruft der Befehl zunächst Get-CsProxyConfiguration ohne Parameter auf, um eine Auflistung aller in der Organisation verwendeten Proxyeinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "AcceptServerCompression" den Wert "True" aufweist. Die gefilterte Auflistung wird anschließend an das Cmdlet Set-CsProxyConfiguration weitergeleitet, das die Eigenschaft "AcceptClientCompression" für jedes Element in der Auflistung auf "True" festlegt.

-------------------------- Beispiel 3 --------------------------

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

In Beispiel 3 wird gezeigt, wie alle auf Dienstebene konfigurierten Proxyeinstellungen geändert werden können. Dazu ruft der Befehl zunächst Get-CsProxyConfiguration mit dem Parameter "Filter" auf. Der Filterwert "service:*" stellt sicher, dass nur Einstellungen zurückgegeben werden, deren Identitätswert mit dem Zeichenfolgenwert "service:" beginnt. Die gefilterte Auflistung wird anschließend an das Cmdlet Set-CsProxyConfiguration weitergeleitet, das die Eigenschaft "UseNtlmForClientToProxyAuth" für jedes Element in der Auflistung auf "False" festlegt.

Siehe auch

Weitere Ressourcen

Get-CsProxyConfiguration
New-CsProxyConfiguration
Remove-CsProxyConfiguration