Freigeben über

  • Artikel

New-CsFileTransferFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue Konfiguration für Dateiübertragungsfilter. Mithilfe der Konfigurationen für Dateiübertragungsfilter soll verhindert werden, dass ein Benutzer bestimmte Dateitypen (z. B. Dateien mit der Erweiterung ".vbs" oder ".ps1") mithilfe von Microsoft Lync Server 2010-Clients übertragen kann.

Syntax

New-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<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 (i. d. R. Erweiterungen von potenziell schädlichen Dateitypen) nicht mit einem Lync Server 2010-Client gesendet werden dürfen.

Während der Installation von Lync Server 2010 wird eine Konfiguration für Dateiübertragungsfilter erstellt, die auf globaler Ebene angewendet wird. Diese globale Konfiguration gilt standardmäßig für alle Benutzer in Ihrer Organisation. Zusätzlich können Sie mit dem Cmdlet New-CsFileTransferFilterConfiguration benutzerdefinierte Konfigurationen für Dateiübertragungsfilter für einzelne Standorte erstellen. Wenn für einen bestimmten Standort eine Konfiguration vorhanden ist, werden diese Dateiübertragungseinstellungen auf alle Benutzer an diesem Standort angewendet. Wenn für einen Standort keine solche Auflistung besteht, gelten stattdessen die globalen Einstellungen.

Beachten Sie, dass Sie keine neue Konfiguration für Dateiübertragungsfilter auf globaler Ebene erstellen können. Sie können jedoch mit dem Cmdlet Set-CsFileTransferFilterConfiguration die globale Einstellungen ändern. Gleichermaßen können Sie keine neue Konfiguration für einen Standort erstellen, der bereits über eine Konfiguration verfügt. In diesem Fall tritt bei der Ausführung des Befehls ein Fehler auf.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID, die der Konfiguration für Dateiübertragungsfilter zugewiesen wird. Der Identitätswert der neuen Konfiguration besteht lediglich aus dem Präfix "site:", gefolgt von dem Standortnamen. Wenn Sie beispielsweise eine neue Konfiguration für den Standort "Redmond" erstellen möchten, verwenden Sie die folgende Syntax: -Identity site:Redmond.

Action

Optional

Zeichenfolge

Legt die Aktion fest, die bei Aktivierung der Dateiübertragungsfilterung ausgeführt wird. Wenn "BlockAll" festgelegt ist, werden alle Dateiübertragungen unabhängig von der Dateierweiterung verhindert. Wenn "Block" (Standardwert) festgelegt ist, werden Dateiübertragungen nur dann zugelassen, wenn die Dateierweiterung keinem der unzulässigen Dateitypen entspricht, die in der Eigenschaft "Extensions" angegeben wurden.

Wenn die Dateiübertragung uneingeschränkt zugelassen werden soll (d. h. Benutzer dürfen jeden Dateityp unabhängig von seiner Dateierweiterung austauschen), legen Sie die Eigenschaft "Enabled" dieser Richtlinie auf "False" fest.

Enabled

Optional

Boolescher Wert

Aktiviert oder deaktiviert die Filterung von Dateiübertragungen. Wenn dieser Parameter auf "True" festgelegt ist, können Dateien mit den angegebenen Erweiterungen (oder alle Dateien, je nach Wert der Eigenschaft "Action") nicht mit einem Lync Server 2010-Client übertragen werden. Wird für diesen Parameter "False" festgelegt, kann jede Datei übertragen werden.

Standard: True.

Extensions

Optional

PSListModifier

Liste der Dateierweiterungen, die blockiert werden. Wenn Sie versuchen, mit einem Lync Server 2010-Client eine Datei zu übertragen, die eine der in dieser Liste enthaltenen Dateierweiterungen aufweist, wird diese Dateiübertragung blockiert und die Datei nicht übertragen. Diese Liste wird ignoriert, wenn "Action" auf "BlockAll" (alle Dateiübertragungen werden blockiert) oder "Enabled" auf "False" (Dateiübertragungen werden nie blockiert) festgelegt ist.

Standardmäßig sind die folgenden Dateierweiterungen in der Eigenschaft "Extensions" enthalten: .ade, .adp, .app, .asp, .bas, .bat, .cer, .chm, .cmd, .com, .cpl, .crt, .csh, .exe, .fxp, .grp, .hlp, .hta, .inf, .ins, .isp, .its, .js, .jse, .ksh, .lnk, .mad, .maf, .mag, .mam, .maq, .mar., mas., .mat, .mau, .mav, .maw, .mda, .mdb. .mde, .mdt, .mdw, .mdz, .msc, .msi, .msp, .mst, .ocx, .ops, .pcd, .pif, .pl, .pnp, .prf, .prg, .pst, .reg, .scf, .scr, .sct, .shb, .shs, .tmp, .url, .vb, .vbe, .vbs, .vsd, .vsmacros, .vss, .vst, .vsw, .ws, .wsc. .wsf, .wsh

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

Mit New-CsFileTransferFilterConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration" erstellt.

Beispiel

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond

Im vorstehenden Befehl wird mit New-CsFileTransferFilterConfiguration eine neue Konfiguration für Sofortnachrichten-Dateiübertragungsfilter mit dem Identitätswert "site:Redmond" erstellt. Da keine zusätzlichen Parameter angegeben wurden, wird diese Konfiguration mit den Standardwerten erstellt.

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Add=".ps1"}

In diesem Befehl wird mit New-CsFileTransferFilterConfiguration eine neue Konfiguration für Dateiübertragungsfilter mit dem Identitätswert "site:Redmond" erstellt. Da der Parameter "Extensions" angegeben wurde, enthält die neue Konfiguration alle Standardwerte sowie eine zusätzliche Dateierweiterung: .ps1. Diese neue Erweiterung wird hinzugefügt, indem der Parameter "Extensions" und der Listenmodifizierer "Add", gefolgt von der Dateierweiterung, die hinzugefügt werden soll, verwendet werden. (Beachten Sie, dass der Punkt als Teil der Dateierweiterung angegeben werden muss.) Mehrere Dateierweiterungen werden mithilfe von Kommas voneinander getrennt: @{Add=".ps1",".ps2",".ps3"}

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Replace=".vbs",".ps1"}

In Befehl 3 wird mit New-CsFileTransferFilterConfiguration eine neue Konfiguration für Dateiübertragungsfilter mit dem Identitätswert "site:Redmond" erstellt. Dieses Beispiel ähnelt Beispiel 2, mit Ausnahme des Listenmodifizierers "Replace", der hier statt des Modifzierers "Add" verwendet wurde. Dies bedeutet, dass sämtliche Dateierweiterungen durch die zwei angegebenen Dateierweiterungen ersetzt werden: ".vbs" und ".ps1". In diesem Fall werden am Standort "Redmond" nur Dateien mit der Erweiterung ".vbs" und ".ps1" blockiert.

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

$x = New-CsFileTransferFilterConfiguration -Identity site:Redmond -InMemory 
$x.Action = "BlockAll"
Set-CsFileTransferFilterConfiguration -Instance $x

Beispiel 4 zeigt die Verwendung des Parameters "InMemory" für das Erstellen einer Konfiguration für Dateiübertragungsfilter, die zunächst nur im Arbeitsspeicher vorhanden ist. Hierzu verwendet der erste Befehl im Beispiel New-CsFileTransferFilterConfiguration und den Parameter "InMemory", um eine neue Konfiguration für Dateiübertragungsfilter mit dem Identitätswert "site:Redmond" zu erstellen. Zu diesem Zeitpunkt sind die neuen Einstellungen nur im Arbeitsspeicher abgelegt, und für die Benutzer am Standort "Redmond" gelten weiterhin die globalen Einstellungen für Dateiübertragungsfilter.

Im zweiten Befehl ist der Wert der Eigenschaft "Action" für diese Instanz im Arbeitsspeicher auf "BlockAll" festgelegt. Schließlich erstellt der dritte Befehl im Beispiel mit Set-CsFileTransferFilterConfiguration die neue Auflistung von Einstellungen und wendet sie auf den Standort "Redmond" an.

Beachten Sie, dass dieselbe Aufgabe mit dem folgenden Befehl in einem Schritt ausgeführt werden kann:

New-CsFileTransferFilterConfiguration -Identity site:Redmond –Action "BlockAll"