• Artikel

Get-CsProxyConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den derzeit in Ihrer Organisation verwendeten Konfigurationseinstellungen für Proxyserver zurück.

Syntax

Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <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 Get-CsProxyConfiguration können Sie Informationen zu allen Konfigurationseinstellungen für Proxyserver abrufen, die derzeit in Ihrer Organisation verwendet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebenden Konfigurationseinstellungen für Proxyserver. Verwenden Sie folgende Syntax, um die globalen Einstellungen zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Sie Platzhalter einsetzen möchten (oder müssen), verwenden Sie den Parameter "-Filter".

Wenn dieser Parameter nicht angegeben ist, gibt Get-CsProxyConfiguration eine Auflistung aller Proxyservereinstellungen zurück, die derzeit in Ihrer Organisation verwendet werden.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Proxykonfigurationseinstellungen. Verwenden Sie beispielsweise folgende Syntax, um alle auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Filter "service:*".

Sie können die Parameter "Filter" und "Identity" nicht im gleichen Befehl verwenden.

LocalStore

Optional

Switch-Parameter

Ruft die Proxykonfigurationsdaten aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsProxyConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsProxyConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings" zurückgegeben.

Beispiel

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

Get-CsProxyConfiguration

Der Befehl in Beispiel 1 gibt eine Auflistung aller Proxykonfigurationseinstellungen zurück, die derzeit in der Organisation verwendet werden. Dazu wird Get-CsProxyConfiguration ohne Parameter aufgerufen.

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

Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"

In Beispiel 2 werden die Proxykonfigurationseinstellungen mit dem Identitätswert "service:EdgeServer:atl-edge-001.litwareinc.com" zurückgegeben. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur eine Auflistung von Einstellungen zurück.

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

Get-CsProxyConfiguration -Filter "service:*"

Mit dem vorstehenden Befehl werden Informationen zu allen Proxyeinstellungen zurückgegeben, die auf Dienstebene konfiguriert wurden. Dazu ruft der Befehl zunächst Get-CsProxyConfiguration mit dem Parameter "Filter" auf. Der Filterwert "service:*" stellt sicher, dass nur Einstellungen mit einem Identitätswert herausgefiltert werden, der mit dem Zeichenfolgenwert "service:" beginnt.

-------------------------- Beispiel 4 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}

In Beispiel 4 werden Informationen zu Proxykonfigurationseinstellungen zurückgegeben, die keine Clientzertifikate als Authentifizierungsmechanismus zulassen. Dazu ruft der Befehl zunächst Get-CsProxyConfiguration auf, um eine Auflistung aller derzeit verwendeten Proxykonfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "UseCertificateForClientToProxyAuth" den Wert "False" aufweist.

-------------------------- Beispiel 5 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}

Mit dem vorstehenden Befehl werden alle Proxykonfigurationseinstellungen zurückgegeben, bei denen die maximale Textgröße für Clientnachrichten höchstens 5000 Kilobyte beträgt. Dazu ruft der Befehl zunächst Get-CsProxyConfiguration ohne Parameter auf. Dadurch wird eine Auflistung aller derzeit verwendeten Proxykonfigurationseinstellungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxClientMessageBodySizeKb" einen geringeren Wert als 5000 aufweist.