Freigeben über

  • Artikel

Get-CsImFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt die in Ihrer Organisation konfigurierten Linkfilter für Instant Messaging (Sofortnachrichten) zurück. Diese Filter verhindern das Senden von Sofortnachrichten, die Links mit bestimmten Präfixen (z. B. "http" oder "telnet") enthalten. Je nach Ihren Einstellungen werden alle URIs (Uniform Resource Identifier), denen ein solches Schema vorangestellt ist, in nicht anklickbare Links konvertiert, oder vollständig gelöscht.

Syntax

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

Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Beim Senden von Sofortnachrichten können Benutzer einen URI im Nachrichtentext einbetten, um andere Gesprächsteilnehmer an eine bestimmte Website oder -freigabe zu verweisen. Microsoft Lync Server 2010 kann so konfiguriert werden, dass Links mit bestimmten Präfixen blockiert werden oder nicht aktiv sind. (Anders ausgedrückt: Die Teilnehmer können nicht einfach auf den Link klicken, um zur Site zu gelangen, auf die der URI verweist. Sie müssen den Link stattdessen kopieren und manuell in einen Browser einfügen.)

Das Cmdlet Get-CsImFilterConfiguration ruft alle Einstellungen für das Filtern von URIs aus Sofortnachrichten ab. Durch Aufrufen von Get-CsImFilterConfiguration ohne Parameter werden alle URI-Filtereinstellungen für Instant Messaging (global sowie für alle Standorte) zurückgegeben. Sie können auch eine Identität angeben, um die Einstellungen für einen bestimmten Standort (oder die globalen Einstellungen) anzuzeigen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Einstellungen, die abgerufen werden sollen. Sie lautet entweder "Global" oder "Site:<Standortname>" (wobei <Standortname> dem Namen des Standorts entspricht, für den diese Einstellungen gelten, z. B. "site:Redmond").

Vollständiger Datentyp: Microsoft.Rtc.Management.Xds.XdsIdentity

Filter

Optional

Zeichenfolge

Führt eine Platzhaltersuche nach Konfigurationen aus, die mit einem bestimmten Identitätsmuster übereinstimmen. Gibt beispielsweise alle Einstellungen zurück, deren Identität mit "site*" beginnt (alle standortspezifischen Einstellungen).

LocalStore

Optional

Switch-Parameter

Ruft die Konfiguration für Sofortnachrichtenfilter aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsImFilterConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration" zurückgegeben.

Beispiel

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

Get-CsImFilterConfiguration

Der oben dargestellte Befehl gibt eine Auflistung aller Hyperlinkfilter für Sofortnachrichten zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. Dies ist das Verhalten beim Aufrufen von Get-CsImFilterConfiguration ohne zusätzliche Parameter.

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

Get-CsImFilterConfiguration -Identity site:Redmond

Mit dem vorstehenden Beispiel werden Einstellungen für einen Sofortnachrichtenfilter zurückgegeben: Einstellungen mit dem Identitätswert "site:Redmond". Da Identitätswerte eindeutig sein müssen, kann dieser Befehl immer nur eine Konfiguration zurückgeben.

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

Get-CsImFilterConfiguration -Filter site:*

In Beispiel 3 wird der Parameter "Filter" zum Zurückgeben einer Auflistung aller Sofortnachrichtenfilter verwendet, die auf Standortebene konfiguriert wurden. Die Platzhalterzeichenfolge "site:*" weist Get-CsImFilterConfiguration an, nur Konfigurationen für Sofortnachrichtenfilter zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

(Get-CsImFilterConfiguration -Identity Global).Prefixes

In Beispiel 4 wird der Wert der Eigenschaft "Prefix" der globalen Konfiguration für Sofortnachrichtenfilter auf der Bildschirmanzeige "erweitert", d. h., die Eigenschaft und ihre Werte werden in einem benutzerfreundlicheren und besser lesbaren Format angezeigt. Dazu wird zunächst Get-CsImFilterConfiguration verwendet, um die globale Konfiguration für Sofortnachrichtenfilter zurückzugeben. (Beachten Sie, dass der Aufruf von Get-CsImFilterConfiguration in Klammern gesetzt wird. Dadurch wird Windows PowerShell angewiesen, zuerst den in Klammern stehenden Befehl auszuführen.) Nachdem die Konfiguration abgerufen wurde, wird der Wert der Eigenschaft "Prefixes" angezeigt, wobei jedes Präfix in einer eigenen Zeile angezeigt wird.