Freigeben über

  • Artikel

Get-CsFileTransferFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt die Konfigurationen für Dateiübertragungsfilter in Ihrer Organisation zurück. Mit diesen Konfigurationen wird verhindert, dass ein Benutzer bestimmte Dateitypen (z. B. Dateien mit der Erweiterung ".vbs" oder ".ps1") mithilfe eines Microsoft Lync Server 2010-Clients übertragen kann.

Syntax

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

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

Detaillierte Beschreibung

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

Mithilfe des Cmdlets Get-CsFileTransferFilterConfiguration können Sie eine bestimmte Auflistung von Einstellungen abrufen (diese Einstellungen können global oder auf Standortebene konfiguriert werden). Konfigurationen für Dateiübertragungsfilter umfassen die Liste der Dateierweiterungen, die bei Übertragungen blockiert werden, die Filterungsstufe (ob alle Dateiübertragungen oder nur Dateien mit den angegebenen Erweiterungen blockiert werden) sowie die Festlegung, ob die Dateiübertragungsfilterung aktiviert ist.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID für die Dateiübertragungskonfiguration, die abgerufen werden soll. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf die auf Standortebene konfigurierten Einstellungen zu verweisen: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Sie Platzhalter verwenden möchten, verwenden Sie stattdessen den Parameter "Filter".

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Konfigurationen für Dateiübertragungsfilter. Verwenden Sie beispielsweise folgende Syntax, um alle Konfigurationen für Dateiübertragungsfilter auf Standortebene zurückzugeben. -Filter "site:*". Konfigurationen für Dateiübertragungsfilter, deren Identität (die einzige filterbare Eigenschaft) mit dem Zeichenfolgenwert "site:" beginnt, wurden auf Standortebene konfiguriert.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine.

Rückgabetypen

Mit dem Cmdlet Get-CsFileTransferFilterConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration" zurückgegeben.

Beispiel

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

Get-CsFileTransferFilterConfiguration

Der Befehl in Beispiel 1 gibt eine Auflistung aller Konfigurationen für Dateiübertragungsfilter zur Verwendung in der Organisation zurück. Dies ist das Standardverhalten beim Aufrufen von Get-CsFileTransferFilterConfiguration ohne zusätzliche Parameter.

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

Im vorstehenden Beispiel wird eine einzelne Konfiguration für Dateiübertragungsfilter zurückgegeben: die Konfiguration 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-CsFileTransferFilterConfiguration -Filter site:*

In Beispiel 3 wird der Parameter "Filter" zum Zurückgeben einer Auflistung aller Konfigurationen für Dateiübertragungsfilter auf Standortebene verwendet. Der Filterwert "site:*" weist Get-CsFileTransferFilterConfiguration an, nur Konfigurationen zurückzugeben, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt.

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

Get-CsFileTransferFilterConfiguration | Where-Object {$_.Extensions -contains ".xls"}

Über den Befehl in Beispiel 4 werden lediglich Konfigurationen für Dateiübertragungsfilter zurückgegeben, bei denen die Liste der nicht zulässigen Dateierweiterungen das XLS-Dateiformat enthält. Hierzu wird zunächst Get-CsFileTransferFilterConfiguration verwendet, um eine Auflistung aller Konfigurationen in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, um einen Filter zum Einschränken der zurückgegebenen Daten auf Konfigurationen anzuwenden, welche die Zeichenfolge ".xls" in der Eigenschaft "Extensions" enthalten (-contains).

-------------------------- Beispiel 5 --------------------------

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

Mit dem vorstehenden Befehl werden alle Konfigurationen für Dateiübertragungsfilter zurückgegeben, die derzeit deaktiviert sind. Hierzu wird Get-CsFileTransferFilterConfiguration verwendet, um eine Auflistung aller Konfigurationen in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Konfigurationen herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "True" ($True) aufweist (der Vergleichsoperator "-eq" steht für "equal to").

-------------------------- Beispiel 6 --------------------------

Get-CsFileTransferFilterConfiguration -Identity Global | Select-Object -ExpandProperty Extensions

In Beispiel 6 wird eine vollständige Liste der Dateierweiterungen angezeigt, die gemäß der globalen Konfiguration für Dateiübertragungsfilter nicht zulässig sind. Bei diesem Befehl wird zunächst das Cmdlet Get-CsFileTransferFilterConfiguration mit Angabe der Konfiguration "Global" aufgerufen. Die zurückgegebenen Informationen werden anschließend an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" verwendet, um den Wert der Eigenschaft "Extensions" zu "erweitern". Dies führt zur Anzeige der vollständigen Liste mit Dateierweiterungen auf dem Bildschirm (eine Dateierweiterung pro Zeile).