Partager via

  • Article

Remove-CsFileTransferFilterConfiguration

 

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

Supprime la configuration de filtre de transfert de fichiers spécifiée dans des messages instantanés. (Les paramètres du filtre de transfert de fichiers des messages instantanés permettent d’empêcher un utilisateur de transférer certains types de fichiers dans un message instantané.)

Syntaxe

Remove-CsFileTransferFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. Microsoft Lync Server 2010 peut être configuré pour que les fichiers dotés de certaines extensions (notamment les extensions des types de fichiers potentiellement nuisibles) ne puissent pas être envoyés à l’aide d’un client Lync Server 2010.

La cmdlet Remove-CsFileTransferFilterConfiguration vous permet de supprimer une configuration de filtre de transfert de fichiers. Pour les configurations définies au niveau de l’étendue Site, Remove-CsFileTransferFilterConfiguration supprimera la configuration. Les utilisateurs sur le site hériteront alors automatiquement de la configuration globale du filtre de transfert de fichiers. La cmdlet Remove-CsFileTransferFilterConfiguration peut également être exécutée et appliquée pour la configuration globale. Dans ce cas, toutefois, la collection globale ne sera pas supprimée. Au lieu de cela, les valeurs par défaut de toutes les propriétés de cette collection seront rétablies.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la configuration de transfert de fichiers à supprimer. Pour préciser la collection globale, utilisez la syntaxe suivante : -Identity global. Pour spécifier une configuration au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Notez que les valeurs de caractères génériques ne sont pas autorisées pour spécifier une identité.

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 de filtre de transfert de fichiers.

Types de retours

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

Exemple

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

Remove-CsFileTransferFilterConfiguration -Identity site:Redmond

Dans l’exemple ci-dessus, la cmdlet Remove-CsFileTransferFilterConfiguration est utilisée pour supprimer la configuration de filtre de transfert de fichiers dont l’identité est site:Redmond.

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

Get-CsFileTransferFilterConfiguration -Filter site:* | Remove-CsFileTransferFilterConfiguration

Dans l’exemple 2, toutes les configurations de filtre de transfert de fichiers au niveau de l’étendue Site sont supprimées. Pour réaliser cette tâche, la commande utilise d’abord Get-CsFileTransferFilterConfiguration et le paramètre Filter pour retourner toutes les configurations 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: ». La collection filtrée des configurations est ensuite redirigée vers la cmdlet Remove-CsFileTransferFilterConfiguration qui supprime chaque élément de la collection.

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

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

L’exemple 3 vous indique comment supprimer toutes les configurations de filtre de transfert de fichiers actuellement désactivées. Pour ce faire, la commande utilise d’abord Get-CsFileTransferFilterConfiguration pour retourner une collection de toutes les configurations de filtre de transfert de fichiers actuellement utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les configurations de filtre de transfert de fichiers dont la propriété Enabled est égale (-eq) à False ($False). Cette collection filtrée est ensuite redirigée vers la cmdlet Remove-CsFileTransferFilterConfiguration qui procède à la suppression de chaque élément au sein de cette collection.