Freigeben über

  • Artikel

Remove-CsFileTransferFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt die Konfiguration des angegebenen Sofortnachrichten-Dateiübertragungsfilters. (Mit Einstellungen für Sofortnachrichten-Dateiübertragungsfilter wird verhindert, dass der Benutzer bestimmte Dateitypen in einer Sofortnachricht übertragen kann.)

Syntax

Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Beim Senden von Sofortnachrichten können Benutzer Dateien anhängen und an andere Gesprächsteilnehmer senden. Microsoft Lync Server 2010 kann so konfiguriert werden, dass bestimmte Dateierweiterungen (i. d. R. Erweiterungen von potenziell schädlichen Dateitypen) nicht mit einem Lync Server 2010-Client gesendet werden dürfen.

Mit dem Cmdlet Remove-CsFileTransferFilterConfiguration können Sie eine Konfiguration für Dateiübertragungsfilter löschen. Bei Konfigurationen auf Standortebene wird die Konfiguration mit Remove-CsFileTransferFilterConfiguration entfernt. Die Benutzer am Standort übernehmen dann automatisch die globale Konfiguration für Dateiübertragungsfilter. Remove-CsFileTransferFilterConfiguration kann auch für die globale Konfiguration ausgeführt werden. In diesem Fall wird die globale Konfiguration jedoch nicht wirklich entfernt; vielmehr werden alle Eigenschaftswerte in dieser Konfiguration auf ihre Standardwerte zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID für die Dateiübertragungskonfiguration, die entfernt werden soll. Verwenden Sie diese Syntax, um auf die globale Konfiguration zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Konfiguration auf Standortebene zu verweisen: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können.

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.FileTransferFilterConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von Konfigurationsobjekten für Dateiübertragungsfilter.

Rückgabetypen

Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration" konfiguriert.

Beispiel

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

Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

Im vorstehenden Beispiel wird die Konfiguration für Dateiübertragungsfilter mit dem Identitätswert "site:Redmond" mithilfe von Remove-CsFileTransferFilterConfiguration entfernt.

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

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

In Beispiel 2 werden alle auf Standortebene konfigurierten Konfigurationen für Dateiübertragungsfilter entfernt. Zu diesem Zweck gibt der Befehl zunächst mithilfe von Get-CsFileTransferFilterConfiguration und dem Parameter "Filter" alle Konfigurationen auf Standortebene zurück. Der Filterwert "site:*" weist Get-CsFileTransferFilterConfiguration an, nur Konfigurationen zurückzugeben, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Die gefilterte Konfigurationsauflistung wird dann an das Cmdlet Remove-CsFileTransferFilterConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsFileTransferFilterConfiguration

In Beispiel 3 wird gezeigt, wie Sie alle derzeit deaktivierten Konfigurationen für Dateiübertragungsfilter entfernen können. Hierzu gibt der Befehl zunächst mit Get-CsFileTransferFilterConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Konfigurationen für Dateiübertragungsfilter zurück. Diese Informationen werden an das Cmdlet Where-Object weitergeleitet, das nur die Konfigurationen für Dateiübertragungsfilter auswählt, bei denen die Eigenschaft "Enabled" den Wert "False" ($False) aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese gefilterte Auflistung wird anschließend an Remove-CsFileTransferFilterConfiguration weitergeleitet, um alle Elemente der gefilterten Auflistung zu löschen.