Partager via

  • Article

Set-CsImFilterConfiguration

 

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

Modifie une configuration de filtre de message instantané (IM) existante. Les paramètres de filtre de message instantané sont utilisés pour empêcher les utilisateurs d'envoyer des messages instantanés contenant des liens hypertexte interactifs (cliquables).

Syntaxe

Set-CsImFilterConfiguration [-Identity <XdsIdentity>] [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Set-CsImFilterConfiguration [-Action <Allow | Block | Warn>] [-AllowMessage <String>] [-BlockFileExtension <$true | $false>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreLocal <$true | $false>] [-Instance <PSObject>] [-Prefixes <PSListModifier>] [-WarnMessage <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Lors de l’envoi de 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 référencé par l’URI, mais devront copier et coller le lien manuellement dans un navigateur.)

La cmdlet Set-CsImFilterConfiguration vous permet de modifier la liste des préfixes URI qui seront filtrés, mais aussi d'activer et de désactiver complètement le filtrage, que ce soit globalement ou sur un site spécifique. Avec cette cmdlet, vous pouvez également mettre à jour divers messages d'avertissements aux utilisateurs.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique des paramètres de configuration de filtre de message instantané que vous souhaitez modifier. Cette valeur sera soit de type global ou site:<nom_site>, où <nom_site> est le site auquel la configuration s’applique (par exemple, site:Redmond).

Instance

Facultatif

ImFilterConfiguration

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Cette cmdlet accepte un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration, qui peut être récupéré en appelant la cmdlet Get-CsImFilterConfiguration.

Action

Facultatif

UrlFilterAction

La valeur de ce paramètre détermine l’action effectuée lorsqu’un lien hypertexte est inclus dans un message instantané :

Allow - Les liens hypertexte sont précédés d’un trait de soulignement afin que les liens ne soient plus actifs. De plus, si un message est spécifié dans la propriété AllowMessage, un message de notification sera inséré au début de chaque message instantané contenant des liens hypertexte.

Block - La remise des messages contenant des liens hypertexte est bloquée et Lync Server 2010 envoie un message d’erreur à l’expéditeur.

Warn - Les messages contenant des liens hypertexte sont remis aux participants destinataires, ainsi qu’un message d’avertissement qui est inséré au début de ces messages. Le message d’avertissement peut être spécifié à l’aide de la propriété WarnMessage. Si Warn est spécifié et qu’aucun message d’avertissement n’est entré, le filtrage des messages instantanés est désactivé, même si les paramètres de la propriété BlockFileExtension seront toujours appliqués.

AllowMessage

Facultatif

Chaîne

Si une valeur est spécifiée pour ce paramètre, cette chaîne est insérée au début de chaque message contenant des liens hypertexte lorsque la valeur de la propriété Action est définie sur Allow. Vous pouvez utiliser ce message pour notifier aux utilisateurs des éléments comme les risques potentiels liés à la sélection de liens inconnus ou les exigences et politiques pertinentes de votre organisation.

BlockFileExtension

Facultatif

Booléen

Si ce paramètre est défini sur True, un lien hypertexte contenant un chemin d'accès au fichier avec une extension spécifiée par la propriété Extensions qui est définie dans la classe Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.FileTransferFilterConfiguration (extraite par l'appel de la cmdlet Get-CsFileTransferFilterConfiguration) est bloqué et un message d'erreur est retourné à l'expéditeur. Si ce paramètre est défini sur False, aucun contrôle spécifique n’est effectué sur les chemins d’accès au fichier et les extensions.

Valeur par défaut : True

Enabled

Facultatif

Booléen

Active ou désactive cette fonction. Si ce paramètre est défini sur True, les liens hypertexte seront recherchés dans les messages instantanés et les règles de cette configuration seront appliquées. Si ce paramètre est défini sur False, les liens hypertexte ne seront pas recherchés dans les messages.

Valeur par défaut : True

IgnoreLocal

Facultatif

Booléen

La valeur de ce paramètre détermine si le filtrage doit être effectué sur les URI d’intranet local transmis dans les messages instantanés. Si ce paramètre est défini sur True, tout URI défini dans la zone Intranet de l’ordinateur local est ignoré. (L'ordinateur local est le serveur frontal exécutant l'application de filtre de message instantané.) Si ce paramètre est défini sur False, le filtrage spécifié s’applique à tous les liens hypertexte.

Valeur par défaut : True

Prefixes

Facultatif

Modificateur de liste PS

Liste des préfixes URI qui seront filtrés. Tout lien hypertexte inclus dans un message instantané et dont le préfixe correspond à l’un des préfixes présents dans cette liste sera filtré sur la base des paramètres spécifiés.

Valeur par défaut : callto:, file:, ftp., ftp:, gopher:, href, http:, https:, ldap:, mailto:, news:, nntp:, sip:, sips:, tel:, telnet:, www*.

WarnMessage

Facultatif

Chaîne

Ce paramètre contient le message d’avertissement qui est inséré au début de chaque message instantané contenant des liens hypertexte lorsque la valeur de la propriété Action est définie à Warn. En règle générale, ce message sera utilisé pour indiquer, par exemple, les risques potentiels engendrés par le fait de cliquer sur des liens inconnus ou de faire référence aux stratégies et besoins importants de votre organisation.

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 de filtre de messagerie instantanée.

Types de retours

Set-CsImFilterConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.

Exemple

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

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

La commande présentée dans cet exemple désactive le filtrage URI pour les paramètres de filtre de message instantané dont l'identité est site:Redmond. Pour effectuer cette tâche, le paramètre Enabled est spécifié lors de l'appel de la cmdlet Set-CsImFilterConfiguration avec la valeur $False.

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

$x = Get-CsImFilterConfiguration -Identity site:Redmond
$x.Prefixes.Add("urn:")
Set-CsImFilterConfiguration -Instance $x

Le groupe de commandes précédent ajoute un nouveau préfixe URI (urn:) à la liste des préfixes interdits par la configuration du filtre de messagerie instantanée de site:Redmond. Pour ajouter le nouveau préfixe, la cmdlet Get-CsImFilterConfiguration est utilisée pour récupérer la configuration de site:Redmond ; l'objet retourné représentant cette configuration est stocké dans une variable nommée $x. Une fois les paramètres extraits, la méthode Add() est appelée à la ligne 2 pour ajouter urn: au groupe de préfixes stocké dans la propriété Prefixes. Cette opération modifie ainsi la valeur de la référence d'objet $x. Pour changer la configuration elle-même, la ligne 3 appelle la cmdlet Set-CsImFilterConfiguration, en transmettant $x comme valeur de paramètre unique.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{add="urn:"}

L’exemple 3 réalise exactement la même action que l’exemple 2, mais sur une seule ligne. Dans cette commande, le paramètre -Prefixes de la cmdlet Set-CsImFilterConfiguration est utilisé pour ajouter urn: à la liste des préfixes. Le modificateur de liste add permet d’ajouter cette valeur à la liste des préfixes.

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

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="urn:"}

Dans cet exemple, le préfixe urn: est supprimé de la liste des préfixes bloqués par la configuration du filtre de messagerie instantanée de site:Redmond. Cet exemple est identique à l’exemple 3, mais au lieu d’appeler le modificateur de liste add pour ajouter un préfixe à la liste, le modificateur remove est appelé pour supprimer un préfixe.