New-CsProxyConfiguration

Syntax

New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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>]]

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. Diese neuen Auflistungen werden mit dem Cmdlet New-CsProxyConfiguration erstellt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsProxyConfiguration"}

Parameter

Eingabetypen

Keine. New-CsProxyConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsProxyConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings" erstellt.

Beispiel

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

New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256

Mit dem vorstehenden Befehl wird eine neue Auflistung von Proxykonfigurationseinstellungen für den Dienst "EdgeServer:atl-edge-001.litwareinc.com" erstellt. Diese neuen Einstellungen verwenden alle Standardeigenschaftswerte für Proxyserver mit Ausnahme von "RequestServerCompression", der auf "True" festgelegt ist, und "MaxClientMessageBodySizeKb", der auf 256 festgelegt ist. Beim Ausführen dieses Befehls tritt ein Fehler auf, wenn Proxyservereinstellungen bereits für den Dienst "EdgeServer:atl-edge-001.litwareinc.com" konfiguriert wurden.

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

$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True 
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x

Die Befehle in Beispiel 2 zeigen, wie Sie eine neue Auflistung von Proxyservereinstellungen erstellen können, die nur im Arbeitsspeicher vorhanden ist. Hierzu ruft der erste Befehl New-CsProxyConfiguration mit zwei Parametern auf: "Identity", der den Identitätswert der Einstellungen angibt, und "InMemory", der angibt, dass die neuen Einstellungen nur im Arbeitsspeicher erstellt werden sollen. Das resultierende Objekt wird in der Variablen "$x" gespeichert.

Nach Erstellung dieser virtuellen Einstellungen dienen die Befehle 2 und 3 zum Ändern der Werte der Eigenschaften "RequestServerCompression" bzw. "MaxClientMessageBodySizeKb". Befehl 4 wird schließlich verwendet, um die virtuellen Konfigurationseinstellungen für Proxyserver in eine tatsächliche Auflistung von Einstellungen umzuwandeln, die auf den Dienst "EdgeServer:atl-edge-001.litwareinc.com" angewendet werden können. Dieser letzte Befehl ist verbindlich. Wenn Sie Set-CsProxyConfiguration nicht aufrufen, werden keine Einstellungen auf "EdgeServer:atl-edge-001.litwareinc.com" angewendet, und die virtuellen Einstellungen gehen verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.

Siehe auch

Weitere Ressourcen

Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration