Partager via

  • Article

Set-CsFileTransferFilterConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Modifie une collection de paramètres de configuration du filtre de transfert de fichiers. Les paramètres du filtre de transfert de fichiers sont utilisés pour bloquer la capacité d’un utilisateur à transférer certains types de fichiers (par exemple, les fichiers présentant l’extension .vbs ou .ps1) à l’aide des clients Microsoft Lync Server 2010.

Syntaxe

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

Description détaillée

Lors de l’envoi de messages instantanés, les utilisateurs peuvent joindre et envoyer des fichiers à d’autres participants à la conversation. Lync Server 2010 peut être configuré pour que les fichiers présentant certaines extensions (notamment les extensions des types de fichiers potentiellement dangereux) ne puissent pas être envoyés par le client.

La capacité des utilisateurs à transférer des fichiers à l’aide des clients Lync Server 2010 est déterminée par les paramètres de configuration du filtre de transfert de fichiers, appliqués au niveau de l’étendue globale ou (facultatif) de l’étendue Site. La cmdlet Set-CsFileTransferFilterConfiguration vous permet de modifier une configuration du filtre de transfert de fichiers existante. Vous pouvez modifier la liste des extensions qui seront bloquées en ajoutant ou en supprimant des extensions, ou en créant une nouvelle liste. Vous pouvez également utiliser cette cmdlet pour activer ou non le filtre de transfert de fichiers et déterminer le niveau auquel il intervient (blocage des fichiers dont les extensions correspondent à celles de la liste d’extensions ou blocage de tous les fichiers).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsFileTransferFilterConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsFileTransferFilterConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique de la configuration de transfert de fichiers que vous souhaitez modifier. Cette valeur sera « global » ou « site:<nom du site> », où <nom du site> est le nom du site auquel appliquer les paramètres, tel que site:Redmond.

Si ce paramètre n’est pas spécifié, Set-CsFileTransferFilterConfiguration mettra à jour, par défaut, les paramètres globaux.

Instance

Facultatif

FileTransferFilterConfiguration

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Cet objet doit être de type FileTransferFilterConfiguration et peut être récupéré en appelant la cmdlet Get-CsFileTransferFilterConfiguration.

Action

Facultatif

Chaîne

Détermine l’action à prendre si cette configuration du filtre de transfert de fichiers est activée. Si ce paramètre est défini sur BlockAll, tous les transferts de fichiers sont interdits, quelle que soit l’extension de fichier. S’il est défini sur Block (la valeur par défaut), les transferts de fichiers sont autorisés sauf si l’extension de fichier figure dans la liste des types de fichiers interdits dans la propriété Extensions.

Pour autoriser tous les transferts de fichiers (c’est-à-dire, pour autoriser les utilisateurs à échanger tout type de fichier, quelle qu’en soit l’extension), définissez la propriété Enabled de cette stratégie sur la valeur False.

Enabled

Facultatif

Booléen

Active ou désactive le filtre de transfert de fichiers. Si ce paramètre est défini sur True, les fichiers présentant les extensions spécifiées (ou tous les fichiers, selon la valeur de la propriété Action) ne peuvent pas être transférés à partir du client. Si ce paramètre est défini sur False, tous les fichiers peuvent être transférés.

Valeur par défaut : True.

Extensions

Facultatif

Liste de chaînes

Liste des extensions de fichiers qui seront bloquées. Si vous essayez d’utiliser un client Lync Server 2010 pour transférer un fichier dont l’extension figure dans cette liste, ce transfert sera bloqué et le fichier ne sera pas transféré. Cette liste est ignorée si le paramètre Action est défini sur BlockAll (tous les transferts de fichiers sont bloqués) ou si Enabled est défini sur False (tous les transferts sont autorisés).

Par défaut, les extensions de fichiers suivantes sont incluses à la propriété Extensions : .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

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration. Accepte la saisie de données transmises via le pipeline pour les objets de configuration du filtre de transfert de fichiers.

Types de retours

Cette cmdlet ne retourne ni valeur, ni objet. Au lieu de cela, elle configure des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemple

-------------------------- Exemple 1 --------------------------

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

La commande illustrée dans l’exemple 1 désactive le filtre de transfert de fichiers pour le site Redmond (c’est-à-dire, la configuration du filtre de transfert de fichiers pour laquelle Identity est site:Redmond). Pour mener cette tâche à bien, le paramètre Enabled est inclus à la commande et défini sur $False.

-------------------------- Exemple 2 --------------------------

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

La commande ci-dessus ajoute une nouvelle extension de fichier (.ps1, l’extension des scripts Windows PowerShell) à la liste des extensions dont le transfert est interdit sur le site Redmond. Pour ajouter la nouvelle extension de fichier, Set-CsFileTransferFilterConfiguration utilise le paramètre Extensions et le modificateur de liste Add. Le modificateur ajoute l’extension spécifiée, .ps1, à la liste des extensions interdites. Pour ajouter plusieurs extensions à l’aide d’une seule commande, séparez-les par une virgule : @{Add=".ps1",".ps2",".ps3"}. Notez que vous devez inclure le point lorsque vous spécifiez une extension de fichier.

-------------------------- Exemple 3 --------------------------

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

Dans l’exemple 3, l’extension de fichier .ps1 est ajoutée à la liste Extensions pour toutes les configurations de filtre de transfert de fichiers actuellement utilisées dans l’organisation. Pour cela, Get-CsFileTransferFilterConfiguration est d’abord appelée, sans paramètre supplémentaire, afin de retourner une collection de toutes les configurations du filtre de transfert de fichiers actuellement utilisées. Cette collection est ensuite redirigée vers Set-CsFileTransferFilterConfiguration, qui ajoute l’extension de fichier .ps1 à chaque élément de la collection.

-------------------------- Exemple 4 --------------------------

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

Dans l’exemple ci-dessus, l’extension de fichier .ps1 est supprimée de la liste des extensions bloquées par la configuration du filtre de transfert de fichiers pour le site Redmond. Cet exemple est identique à l’exemple 3 sauf qu’au lieu d’appeler le modificateur de liste Add pour ajouter une extension à la liste, c’est le modificateur de liste Remove qui est appelé pour en supprimer une.

-------------------------- Exemple 5 --------------------------

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

L'exemple 5 effectue la même action que l'exemple 4 : il supprime l'extension .ps1 de la liste des extensions pour le site Redmond. Toutefois, dans ce cas, nous récupérons d’abord la configuration du filtre de transfert de fichiers pour site:Redmond et attribuons la sortie à la variable $a. $a contient désormais la configuration pour le site Redmond. Ensuite, nous récupérons la propriété Extensions de $a, qui est la propriété Extensions de site:Redmond ($a.Extensions). Cette propriété contient la liste des extensions de fichiers. Ensuite, nous appelons la méthode Remove ($a.Extensions.Remove). Nous passons la valeur .ps1 à la méthode Remove ; cela supprime cette extension de la liste de la propriété Extensions. Toutefois, cela supprime uniquement l’extension du magasin de configuration de la mémoire de la variable $a. Pour appliquer cette modification à la base de données, nous devons appeler Set-CsFileTransferFilterConfiguration, en passant $a au paramètre Instance.