Freigeben über

  • Artikel

New-CsImFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Sofortnachrichten-Filterkonfiguration (Instant Messaging). Sofortnachrichtenfilter sollen verhindern, dass Benutzer Sofortnachrichten senden, die aktive Links enthalten.

Syntax

New-CsImFilterConfiguration -Identity <XdsIdentity> [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-InMemory <SwitchParameter>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Beim Senden von Sofortnachrichten können Benutzer einen URI (Uniform Resource Identifier) 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.)

Mit dem Cmdlet New-CsImFilterConfiguration können Sie, neben einer vollständigen Aktivierung oder Deaktivierung der Filterung, eine Liste der zu filternden URI-Präfixe für einen bestimmten Standort definieren. Durch den Aufruf von New-CsImFilterConfiguration nur nur einem angegebenen Identitätswert wird eine neue Konfiguration mit diesem Identitätswert erstellt; wobei die Liste mit Präfixen für diesen Standort Standardpräfixe enthält, die gefiltert werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID, mit der der Gültigkeitsbereich der Sofortnachrichtenfilterkonfiguration festgelegt wird. Globale Einstellungen sind standardmäßig vorhanden und können nicht mit dem Cmdlet New-CsImFilterConfiguration neu erstellt werden. Sie können jedoch Einstellungen auf Standortebene erstellen, indem Sie den Identitätswert "site:<Standortname>" festlegen, wobei <Standortname< für den Namen des Standorts steht, auf den die Einstellungen angewendet werden (z. B. "site:Redmond").

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

Action

Optional

UrlFilterAction

Der Wert dieses Parameters bestimmt die Aktion, die ausgeführt wird, wenn eine Sofortnachricht einen Link enthält:

Allow. Den Links wird ein Unterstrich vorangestellt, sodass sie nicht mehr aktiv sind. Wenn in der Eigenschaft "AllowMessage" eine Nachricht festgelegt wurde, wird diese Nachricht am Anfang jeder Sofortnachricht mit einem Link eingefügt.

Block. Die Übermittlung von Nachrichten mit aktiven Links wird blockiert, und Lync Server 2010 gibt eine Fehlermeldung an den Sender aus.

Warn. Nachrichten mit aktiven Links werden an die Empfänger zusammen mit einer Warnmeldung übermittelt, die am Anfang dieser Nachrichten eingefügt wird. Diese Warnmeldung kann mithilfe der Eigenschaft "WarnMessage" festgelegt werden. Wenn "Warn" festgelegt und keine Warnmeldung mit "WarnMessage" eingegeben wurde, wird der Sofortnachrichtenfilter deaktiviert, selbst wenn die Einstellungen für die Eigenschaft "BlockFileExtension" weiterhin berücksichtigt werden.

Standard: "Allow", es sei denn eine Nachricht enthält mehr als 1.000 URLs, in diesem Fall lautet die Standardeinstellung "Block".

Vollständiger Datentyp: Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.UrlFilterAction

AllowMessage

Optional

Zeichenfolge

Wenn für diesen Parameter ein Wert festgelegt wurde, wird diese Zeichenfolge am Anfang jeder Nachricht mit einem Link eingefügt, wenn der Wert der Eigenschaft "Action" auf "Allow" festgelegt ist. Sie können mit dieser Nachricht Benutzer darüber informieren, dass das Klicken auf unbekannte Links eine potenzielle Gefahr darstellt, oder sie auf die entsprechenden Richtlinien oder Anforderungen Ihrer Organisation hinweisen.

BlockFileExtension

Optional

Boolescher Wert

Wenn dieser Parameter auf "True" festgelegt wurde, wird ein Link zu einer Datei blockiert, wobei der Dateipfad eine durch die Eigenschaft "Extensions" festgelegte Erweiterung enthält, die in der anwendbaren Filterkonfiguration für Dateiübertragungen definiert wurde (der Abruf erfolgt über das Cmdlet Get-CsFileTransferFilterConfiguration). Darüber hinaus wird eine Fehlermeldung an den Absender zurückgegeben. Wenn dieser Parameter auf "False" festgelegt wurde, findet keine zusätzliche Prüfung der Dateierweiterungen statt.

Standard: True

Enabled

Optional

Boolescher Wert

Aktiviert oder deaktiviert diese Funktion. Wenn dieser Parameter auf "True" festgelegt wurde, werden Sofortnachrichten nach Links durchsucht, und die Regeln in dieser Konfiguration werden angewendet. Wenn dieser Parameter auf "False" festgelegt wurde, werden Nachrichten nicht auf Links hin überprüft.

Standard: True

IgnoreLocal

Optional

Boolescher Wert

Der Wert dieses Parameters bestimmt, ob die Filterung für lokale Intranet-URIs durchgeführt wird, die in Sofortnachrichten übergeben werden. Wenn dieser Parameter auf "True" festgelegt wurde, werden alle URIs ignoriert, die in der Intranetzone des lokalen Computers definiert wurden. (Der lokale Computer ist der Front-End-Server, auf dem die Sofortnachrichten-Filteranwendung ausgeführt wird.) Wenn dieser Parameter auf "False" festgelegt ist, wird der angegebene Filter auf alle Links angewendet.

Standard: True

Prefixes

Optional

PSListModifier

Die Liste mit URI-Präfixen, die herausgefiltert werden. Alle Links in einer Sofortnachricht mit einem Präfix, das einem der Präfixe in dieser Liste entspricht, werden gemäß den festgelegten Einstellungen gefiltert.

Standard: callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

Optional

Zeichenfolge

Dieser Parameter enthält die Warnmeldung, die am Anfang jeder Sofortnachricht mit Links eingefügt wird, wenn der Wert der Eigenschaft "Action" auf "Warn" festgelegt wurde. Diese Nachricht weist in der Regel darauf hin, dass das Klicken auf unbekannte Links eine potenzielle Gefahr darstellt, oder verweist auf die entsprechenden Richtlinien oder Anforderungen Ihrer Organisation.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration".

Beispiel

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

New-CsImFilterConfiguration -Identity site:Redmond

Im vorstehenden Befehl wird mit New-CsImFilterConfiguration eine neue Sofortnachrichten-Filterkonfiguration mit dem Identitätswert "site:Redmond" erstellt. (Da keine zusätzlichen Parameter angegeben wurden, werden diese Einstellungen mit den Standardwerten erstellt.)

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="rtsp:","urn:"}

In diesem Befehl wird mit New-CsImFilterConfiguration eine neue Sofortnachrichten-Filterkonfiguration mit dem Identitätswert "site:Redmond" erstellt. Da der Parameter "Prefixes" angegeben wurde, enthält die neue Konfiguration alle Standardwerte, darunter auch die zu filternden Standardpräfixe, sowie zwei zusätzliche URI-Präfixe: "rtsp:" und "urn:". Mithilfe des Add-Listenmodifizierers werden diese Präfixe der Standardliste hinzugefügt.

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

New-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{replace="rtsp:","urn:"}

In diesem Befehl wird mit New-CsFileTransferFilterConfiguration eine neue Sofortnachrichten-Filterkonfiguration mit dem Identitätswert "site:Redmond" erstellt. Dieses Beispiel ähnelt Beispiel 2, mit Ausnahme des Replace-Listenmodifizierers, der hier statt des Add-Listenmodifizierers verwendet wurde. Das bedeutet, dass alle Standard-URI-Präfixe durch diese beiden Präfixe ersetzt werden ("rtsp:" und "urn:"). Es werden nur URIs mit den Präfixen "rtsp:" oder "urn:" aus Sofortnachrichten für den Standort "Redmond" herausgefiltert.