Partager via

  • Article

Remove-CsImFilterConfiguration

 

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

Supprime la configuration du filtre de messagerie instantanée spécifiée (les paramètres du filtre de messagerie instantanée sont utilisés pour empêcher des utilisateurs d’envoyer des messages instantanés contenant des liens hypertexte).

Syntaxe

Remove-CsImFilterConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Lors de l’envoi des messages instantanés, les utilisateurs peuvent incorporer un URI (Uniform Resource Identifier) dans le texte d’un message pour proposer aux autres participants de la conversation un site Web ou un partage en particulier. Microsoft Lync Server 2010 peut être configuré de sorte que les liens hypertexte comportant certains préfixes soient bloqués ou désactivés. (En d’autres termes, les participants ne pourront pas simplement cliquer sur le lien pour être redirigés vers le site de référence de l’URI ; ils devront en effet copier et coller le lien manuellement dans un navigateur.)

La cmdlet Remove-CsImFilterConfiguration supprime les paramètres du filtre de messagerie instantanée pour une identité donnée (par exemple, un site spécifique). L’exécution de cette cmdlet dans l’identité globale entraîne simplement la restauration de la configuration par défaut des paramètres globaux.

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-CsImFilterConfiguration : 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-CsImFilterConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identité unique de la configuration à supprimer. Il peut s’agir d’une identité globale ou Site : <nom du site> (où <nom du site> correspond au nom du site auquel les paramètres s’appliquent).

Type de données complet : Microsoft.Rtc.Management.Xds.XdsIdentity

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.ImFilterConfiguration. Accepte la saisie de données transmises via le pipeline pour les objets de configuration du filtre de messagerie instantanée.

Types de retours

Supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Exemple

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

Remove-CsImFilterConfiguration -Identity site:Redmond

Dans l’exemple 1, on utilise la cmdlet Remove-CsImFilterConfiguration pour supprimer la configuration du filtre de messagerie instantanée comportant l’identité site:Redmond. Lorsqu’une configuration du filtre de messagerie instantanée est supprimée d’un site, ce dernier commence automatiquement à utiliser les paramètres globaux à sa place.

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

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

Dans l’exemple 2, toutes les configurations du filtre de messagerie instantanée au niveau de l’étendue Site sont supprimées. Pour exécuter cette tâche, la commande utilise d’abord la cmdlet Get-CsImFilterConfiguration et le paramètre Filter pour renvoyer toutes les configurations dans l’étendue Site. Le caractère générique site:* indique à Get-CsImFilterConfiguration que seules les configurations dont l’identité commence par la valeur de chaîne site: doivent être renvoyées. L’ensemble de configurations filtré est ensuite redirigé vers Remove-CsImFilterConfiguration, qui supprime chaque configuration.