Freigeben über

  • Artikel

Remove-CsImFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt die angegebene Sofortnachrichten-Filterkonfiguration (Instant Messaging). (Sofortnachrichten-Filtereinstellungen sollen verhindern, dass Benutzer Sofortnachrichten senden, die Links enthalten.)

Syntax

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

Das Cmdlet Remove-CsImFilterConfiguration entfernt die Sofortnachrichten-Filterkonfiguration für einen bestimmten Identitätswert (z. B. einen spezifischen Standort). Beim Ausführen dieses Cmdlets für den globalen Identitätswert wird die globale Konfiguration wieder auf die Standardeinstellungen zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der eindeutige Identitätswert der zu entfernenden Konfiguration. entweder "Global" oder "Site:<Standortname>" (wobei <Standortname> dem Namen des Standorts entspricht, für den die Einstellungen gelten.).

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

Force

Optional

Switch-Parameter

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

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.ImFilter.ImFilterConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von Sofortnachrichten-Filterkonfigurationsobjekten.

Rückgabetypen

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

Beispiel

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

Remove-CsImFilterConfiguration -Identity site:Redmond

In Beispiel 1 wird Remove-CsImFilterConfiguration verwendet, um die Sofortnachrichten-Filterkonfiguration mit dem Identitätswert "site:Redmond" zu entfernen. Wenn eine Sofortnachrichten-Filterkonfiguration von einem Standort entfernt wird, verwendet dieser Standort stattdessen automatisch die globalen Einstellungen.

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

Get-CsImFilterConfiguration -Filter site:* | Remove-CsImFilterConfiguration

In Beispiel 2 werden alle auf Standortebene konfigurierten Sofortnachrichten-Filterkonfigurationen entfernt. Hierzu gibt der Befehl zunächst mit Get-CsImFilterConfiguration und dem Parameter "Filter" alle auf Standortebene konfigurierten Konfigurationen zurück. Der Platzhalter "site:*" weist Get-CsImFilterConfiguration an, nur die Einstellungen zurückzugeben, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Die gefilterte Konfigurationsauflistung wird dann an das Cmdlet Remove-CsImFilterConfiguration weitergeleitet, das jede Konfiguration in der Auflistung löscht.