Partager via

  • Article

Get-CsFileTransferFilterConfiguration

 

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

Retourne les configurations de filtrage pour le transfert de fichiers dans votre organisation. Ces configurations sont utilisées pour bloquer un utilisateur qui souhaite transférer certains types de fichiers (par exemple, les fichiers dont l’extension est .vbs ou .ps1) à l’aide d’un client Microsoft Lync Server 2010.

Syntaxe

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

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

Description détaillée

Lors de l’envoi 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 avec certaines extensions, généralement des extensions de fichier qui pourraient représenter un risque, ne puissent pas être envoyés à l’aide du client Lync Server 2010.

La cmdlet Get-CsFileTransferFilterConfiguration vous permet de récupérer les paramètres d’une collection de paramètres particuliers (ces paramètres peuvent être configurés au niveau de l’étendue globale ou au niveau de l’étendue Site). Les configurations de filtrage pour le transfert de fichiers comprennent la liste des extensions de fichiers bloqués, le degré de filtrage (tous les transferts de fichiers sont bloqués ou les fichiers avec une extension spécifique uniquement), et selon que le filtrage lors du transfert de fichiers est activé ou non.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la configuration de filtre de transfert de fichiers que vous voulez récupérer. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour indiquer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe semblable à celle-ci : -Identity site:Redmond. Notez que vous ne pouvez pas utiliser de caractères génériques pour spécifier une identité. Si vous avez besoin d’utiliser des caractères génériques, il faut plutôt inclure le paramètre Filter.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques afin de spécifier les configurations du filtre de transfert de fichiers à retourner. Par exemple, pour retourner toutes les configurations du filtre de transfert de fichiers au niveau de l’étendue Site, utilisez la syntaxe suivante : -Filter "site:*". De par leur conception, les configurations du filtre de transfert de fichiers qui ont une identité (la seule propriété que vous pouvez utiliser pour le filtrage) commençant par la valeur de chaîne « site: » ont été configurées au niveau de l’étendue Site.

LocalStore

Facultatif

Paramètre de commutateur

Extrait la configuration du filtre de transfert de fichiers du réplica local de la magasin central de gestion et non de la magasin central de gestion proprement dite.

Types d’entrées

Aucun.

Types de retours

Get-CsFileTransferFilterConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration.

Exemple

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

Get-CsFileTransferFilterConfiguration

La commande indiquée à l’exemple 1 retourne une collection de toutes les configurations du filtre de transfert de fichiers actuellement utilisées dans votre organisation. C’est le comportement par défaut qui fait foi chaque fois que vous appelez Get-CsFileTransferFilterConfiguration sans paramètre supplémentaire.

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

Get-CsFileTransferFilterConfiguration -Identity site:Redmond

L’exemple précédent retourne une seule configuration du filtre de transfert de fichiers : la configuration dont l’identité est site:Redmond. Tenant compte du caractère unique des identités, cette commande ne retourne jamais plus d’une configuration.

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

Get-CsFileTransferFilterConfiguration -Filter site:*

L’exemple 3 utilise le paramètre Filter pour retourner une collection de toutes les configurations du filtre de transfert de fichiers au niveau de l’étendue Site. La valeur de filtre « site:* » instruit Get-CsFileTransferFilterConfiguration de ne retourner que les configurations dont l’identité commence par la valeur de chaîne « site: ».

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

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

La commande indiquée à l’exemple 4 ne retourne que les configurations du filtre de transfert de fichiers qui comprennent .xls dans leur liste d’extensions de fichiers interdites. Pour ce faire, c’est Get-CsFileTransferFilterConfiguration qui est d’abord utilisée pour retourner une collection de toutes les configurations actuellement utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui applique un filtre afin de restreindre les données retournées aux configurations dont la propriété Extensions inclut (-contains) la valeur de chaîne « .xls ».

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

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

La commande précédente retourne toutes les configurations du filtre de transfert de fichiers actuellement désactivées. Pour ce faire, c’est Get-CsFileTransferFilterConfiguration qui est d’abord utilisée pour retourner une collection de toutes les configurations actuellement utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne à son tour uniquement les configurations dont la valeur de la propriété Enabled est égale à (-eq) True ($True).

-------------------------- Exemple 6 --------------------------

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

L’exemple 6 fournit une liste complète d’extensions de fichiers interdits par la configuration globale du filtre de transfert de fichiers. La commande commence par un appel à la cmdlet Get-CsFileTransferFilterConfiguration et spécifie la configuration globale. Les informations retournées sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour « développer » la valeur de la propriété Extensions. Le résultat est une liste complète d’extensions de fichiers affichées à l’écran, avec une extension de fichier par ligne.