• Artikel

Remove-CsProxyConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine vorhandene Auflistung von Konfigurationseinstellungen für Proxyserver.

Syntax

Remove-CsProxyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.

Neu erstellte Einstellungen für Proxyserver können später mit dem Cmdlet Remove-CsProxyConfiguration entfernt werden. Sie können das Cmdlet Remove-CsProxyConfiguration auch für die globale Auflistung ausführen. In diesem Fall werden die globalen Einstellungen jedoch nicht entfernt, da in Lync Server keine globalen Einstellungen entfernt werden dürfen. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt. Über die Einstellungen für Proxyserver dürfen Clients standardmäßig z. B. das Kerberos-Protokoll zur Authentifizierung verwenden. Sie können die globalen Einstellungen ändern, um die Verwendung von Kerberos zu deaktivieren. Beim Ausführen von Remove-CsProxyConfiguration für die globale Auflistung wird die entsprechende Eigenschaft (UseKerberosForClientToProxyAuth) jedoch auf den Standardwert zurückgesetzt, sodass Kerberos erneut zur Verwendung als Authentifizierungsprotokoll aktiviert wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernenden Konfigurationseinstellungen für Proxyserver. Beispiel: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Remove-CsProxyConfiguration kann auch für die globalen Einstellungen ausgeführt werden. In diesem Fall werden die Einstellungen jedoch nicht entfernt. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

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

Rückgabetypen

Keine. Stattdessen werden mit Remove-CsProxyConfiguration bestehende Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings" gelöscht.

Beispiel

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

Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com

Der Befehl in Beispiel 1 löscht die Proxykonfigurationseinstellungen mit dem Identitätswert "service:EdgeServer:atl-edge-litwareinc.com".

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

Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration

In Beispiel 2 werden alle Proxykonfigurationseinstellungen gelöscht, die auf Dienstebene angewendet werden. Hierzu ruft der Befehl zunächst Get-CsProxyConfiguration mit dem Parameter "Filter" auf. Der Filterwert "service:*" stellt sicher, dass nur Proxyeinstellungen zurückgegeben werden, deren Identitätswert mit dem Zeichenfolgenwert "service:*" beginnt.) Diese gefilterte Auflistung wird dann an Remove-CsProxyConfiguration weitergeleitet, um sämtliche Elemente der Auflistung zu löschen.

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

Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration

Über den vorstehenden Befehl werden alle Proxykonfigurationseinstellungen gelöscht, die sämtliche Clients als Remoteclients behandeln. Hierzu wird zunächst Get-CsProxyConfiguration ohne Parameter aufgerufen, um eine Auflistung aller gegenwärtig verwendeten Konfigurationseinstellungen für Proxyserver zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "TreatAllClientsAsRemote" den Wert "True" aufweist. Diese Untermenge an Proxykonfigurationseinstellungen wird dann an das Cmdlet Remove-CsProxyConfiguration weitergeleitet, das alle Einstellungen in der Auflistung entfernt.