Partager via


New-CsFileTransferFilterConfiguration

 

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

Crée une configuration de filtre de transfert de fichiers. Les configurations de 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

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

Description détaillée

Pour envoyer des messages instantanés, les utilisateurs peuvent joindre et envoyer des fichiers aux autres participants à la conversation. Lync Server 2010 peut être configuré pour que les fichiers ayant certaines extensions –typiquement des extensions de fichier qui pourraient représenter un risque– ne puissent pas être envoyés à l’aide d’un client Lync Server 2010.

Lorsque vous installez Lync Server 2010, une configuration de filtre de transfert de fichiers, configurée au niveau de l’étendue Globale, est créée pour vous. Par défaut, la configuration globale s’applique à tous les utilisateurs de votre organisation. Vous pouvez également utiliser la cmdlet New-CsFileTransferFilterConfiguration pour créer des configurations personnalisées de filtre de transfert de fichiers pour des sites individuels. Si une configuration existe pour un site donné, ces paramètres de transfert de fichiers s’appliquent alors à tous les utilisateurs de ce site. Dans le cas contraire, ce sont les paramètres globaux qui s’appliquent.

Notez que vous ne pouvez pas créer de configuration de filtre de transfert de fichiers au niveau de l’étendue Globale ; vous pouvez toutefois utiliser la cmdlet Set-CsFileTransferFilterConfiguration pour modifier les paramètres globaux. De même, vous ne pouvez pas créer de configuration pour un site qui en a déjà une ; si vous effectuez malgré tout une tentative, votre commande échouera.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsFileTransferFilterConfiguration : RTCUniversalServerAdministrator. 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 "New-CsFileTransferFilterConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique à attribuer à la configuration de filtre de transfert de fichiers. L’identité de la nouvelle configuration correspond simplement au préfixe « site: » suivi du nom de site. Par exemple, pour créer une configuration pour le site Redmond, vous utiliseriez la syntaxe suivante : -Identity site:Redmond.

Action

Facultatif

Chaîne

Détermine l’action à entreprendre si le filtrage de transfert de fichiers est activé. 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 à l’aide d’un client Lync Server 2010. Si ce paramètre est défini sur False, tous les fichiers peuvent être transférés.

Valeur par défaut : True.

Extensions

Facultatif

Modificateur de liste PS

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

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

New-CsFileTransferFilterConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemple

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

New-CsFileTransferFilterConfiguration -Identity site:Redmond

Dans la commande ci-dessus, New-CsFileTransferFilterConfiguration permet de créer une configuration de filtre de transfert de fichiers de messages instantanés avec l’identité site:Redmond. Étant donné qu’aucun paramètre supplémentaire n’a été spécifié, la configuration est créée à l’aide des valeurs par défaut.

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

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

Dans cette commande, New-CsFileTransferFilterConfiguration permet de créer une configuration de filtre de transfert de fichiers avec l’identité site:Redmond. Étant donné que le paramètre Extensions a été spécifié, la nouvelle configuration comportera toutes les valeurs par défaut plus une extension de fichier supplémentaire : .ps1. Cette nouvelle extension est ajoutée à l’aide du paramètre Extensions et du modificateur de liste Add suivi de l’extension de fichier à ajouter. (Notez que vous devez inclure le point dans l’extension de fichier.) Pour ajouter plusieurs extensions de fichier, séparez-les simplement par des virgules : @{Add=".ps1",".ps2",".ps3"}

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

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

Dans l’exemple 3, New-CsFileTransferFilterConfiguration permet de créer une configuration de filtre de transfert de fichiers avec l’identité site:Redmond. Cet exemple est similaire à l’exemple 2, hormis le fait que le modificateur de liste Replace a été utilisé à la place du modificateur Add. Cela signifie que l’ensemble complet des extensions de fichiers sera remplacé par les deux extensions spécifiées : .vbs et .ps1. Dans ce cas, les seuls fichiers bloqués au niveau du site Redmond afficheront l’extension .vbs ou .ps1.

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

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

L’exemple 4 montre comment utiliser le paramètre InMemory pour créer une configuration de filtre de transfert de fichiers, qui initialement existe uniquement en mémoire. Pour ce faire, la première commande de l’exemple utilise New-CsFileTransferFilterConfiguration et le paramètre InMemory pour créer une configuration de filtre de transfert de fichiers avec l’identité site:Redmond. À ce stade, les nouveaux paramètres existent uniquement en mémoire ; les utilisateurs sur le site Redmond sont toujours régis par els paramètres de filtre de transfert de fichiers globaux.

Dans la deuxième commande, la valeur de la propriété Action de cette instance en mémoire est définie sur BlockAll. Pour finir, la troisième commande de l’exemple utilise Set-CsFileTransferFilterConfiguration pour créer la collection de paramètres et les appliquer au site Redmond.

Notez que cette même tâche peut être accomplie en une seule étape, à l’aide de la commande suivante :

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