Freigeben über

  • Artikel

Set-CsFileTransferFilterConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine Auflistung von Konfigurationseinstellungen für Dateiübertragungsfilter. Mithilfe der Einstellungen 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

Set-CsFileTransferFilterConfiguration [-Identity <XdsIdentity>] [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsFileTransferFilterConfiguration [-Action <BlockAll | Block>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Extensions <PSListModifier>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 vom Client gesendet werden dürfen.

Die Fähigkeit der Benutzer, Dateien mithilfe von Lync Server 2010-Clients zu übertragen, ist von den Konfigurationseinstellungen für Dateiübertragungsfilter abhängig, die global oder (optional) auf Standortebene angewendet werden. Mit dem Cmdlet Set-CsFileTransferFilterConfiguration können Sie eine vorhandene Konfiguration für Dateiübertragungsfilter ändern. Sie können die Liste mit Erweiterungen ändern, die durch Hinzufügen oder Entfernen von Erweiterungen blockiert werden, oder eine neue Liste erstellen. Mit diesem Cmdlet können Sie auch ändern, ob der Dateiübertragungsfilter aktiviert bzw. deaktiviert ist. Zudem können Sie den Umfang der Blockierung festlegen, d. h ob nur Dateien mit Erweiterungen aus der Erweiterungsliste oder ob alle Dateien blockiert werden sollen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eine eindeutige ID für die Dateiübertragungskonfiguration, die geändert werden soll. Dieser Wert lautet entweder "Global" oder "Site:<Standortname>", wobei <Standortname> der Name des Standorts ist, für den die Einstellungen gelten, z. B. "site:Redmond".

Wenn dieser Parameter nicht angegeben wurde, werden mit Set-CsFileTransferFilterConfiguration standardmäßig die globalen Einstellungen aktualisiert.

Instance

Optional

FileTransferFilterConfiguration

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. Das Objekt muss ein Objekt vom Typ "FileTransferFilterConfiguration" und mit dem CmdletGet-CsFileTransferFilterConfiguration abgerufen werden.

Action

Optional

Zeichenfolge

Legt die Aktion fest, die bei Aktivierung dieser Konfiguration für Dateiübertragungsfilter 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 vom Client übertragen werden. Wird für diesen Parameter "False" festgelegt, kann jede Datei übertragen werden.

Standard: True.

Extensions

Optional

Liste mit Zeichenfolgen

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.

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 --------------------------

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Enabled $False

Der Befehl in Beispiel 1 deaktiviert die Dateiübertragungsfilterung für den Standort "Redmond" (d. h., die Konfiguration für Dateiübertragungsfilter mit dem Identitätswert "site:Redmond"). Hierzu wird der Parameter "Enabled" im Befehl angegeben und auf "$False" festgelegt.

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

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

Mit den vorstehenden Befehlen wird der Liste mit Dateierweiterungen, die am Standort "Redmond" unzulässig sind, eine neue Dateierweiterung hinzugefügt (".ps1", die Dateierweiterung für Windows PowerShell-Skripts). Zum Hinzufügen der neuen Dateierweiterung verwendet Set-CsFileTransferFilterConfiguration den Parameter "Extensions" sowie den Listenmodifizierer "Add". Der Modifizierer fügt die angegebene Dateierweiterung ".ps1" der Liste mit unzulässigen Erweiterungen hinzu. Wenn Sie mehrere Erweiterungen mit nur einem Befehl hinzufügen möchten, trennen Sie die Dateierweiterungen durch Kommas: @{Add=".ps1",".ps2",".ps3"}. Beachten Sie, dass Sie bei der Angabe einer Dateierweiterung den Punkt mit eingeben müssen.

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

Get-CsFileTransferFilterConfiguration | Set-CsFileTransferFilterConfiguration -Extensions @{Add=".ps1"}

In Beispiel 3 wird die Dateierweiterung ".ps1" der Liste mit Erweiterungen für alle derzeit in der Organisation verwendeten Konfigurationen für Dateiübertragungsfilter hinzugefügt. Hierzu ruft der Befehl zunächst Get-CsFileTransferFilterConfiguration ohne zusätzliche Parameter auf, um eine Auflistung aller derzeit verwendeten Konfigurationen für Dateiübertragungsfilter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsFileTransferFilterConfiguration weitergeleitet, das die Dateierweiterung ".ps1" jedem Element in der Auflistung hinzufügt.

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

Set-CsFileTransferFilterConfiguration -Identity site:Redmond -Extensions @{Remove=".ps1"}

Im vorstehenden Beispiel wird die Dateierweiterung ".ps1" aus der Liste mit Erweiterungen entfernt, die für den Standort "Redmond" durch die Konfiguration für Dateiübertragungsfilter blockiert sind. Dieses Beispiel ist mit Beispiel 3 identisch. Allerdings wird anstelle des Add-Listenmodifizierers, mit dem eine Erweiterung der Liste hinzugefügt wird, der Remove-Listenmodifizierer aufgerufen, um aus dieser Liste eine Erweiterungen zu entfernen.

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

$a = Get-CsFileTransferFilterConfiguration -Identity site:Redmond
$a.Extensions.Remove(".ps1")
Set-CsFileTransferFilterConfiguration -Instance $a

In Beispiel 5 wird der gleiche Vorgang ausgeführt wie in Beispiel 4: Die Erweiterung ".ps1" wird aus der Liste der Erweiterungen für Dateiübertragungsfilter für den Standort "Redmond" entfernt. In diesem Fall wird jedoch zunächst die Konfiguration für Dateiübertragungsfilter für "site:Redmond" abgerufen, und die Ausgabe wird der Variablen "$a" zugewiesen. "$a" enthält nun die Konfiguration für den Standort "Redmond". Als Nächstes wird die Eigenschaft "Extensions" aus "$a" abgerufen, d. h. die Eigenschaft "Extensions" von "site:Redmond" ($a.Extensions). Diese Eigenschaft enthält die Liste der Dateierweiterungen. Nach der Eigenschaft "Extensions" wird die Remove-Methode aufgerufen ($a.Extensions.Remove). Der Wert ".ps1" wird an die Remove-Methode übergeben; dadurch wird diese Erweiterung aus der Liste in Eigenschaft "Extensions" entfernt. Die Erweiterung wird jedoch nur aus der Konfiguration entfernt, die im Arbeitsspeicher in der Variablen "$a" gespeichert ist. Um die Änderungen in der Datenbank selbst vorzunehmen, müssen Sie das Cmdlet Set-CsFileTransferFilterConfiguration aufrufen und "$a" an den Parameter "Instance" übergeben.