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.
Siehe auch
Weitere Ressourcen
New-CsFileTransferFilterConfiguration
Set-CsFileTransferFilterConfiguration
Get-CsFileTransferFilterConfiguration