Get-CsImFilterConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne les filtres de lien de messagerie instantanée configurés dans votre organisation. Ces filtres sont utilisés pour empêcher les utilisateurs d’envoyer des messages instantanés qui contiennent des liens hypertexte avec des préfixes spécifiques (par exemple, des liens dont le préfixe est http ou telnet). En fonction de vos paramètres, cela signifie que tout URI (Uniform Resource Identifier) précédé d’un de ces préfixes sera converti en un lien hypertexte non cliquable ou entièrement supprimé.
Syntaxe
Get-CsImFilterConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsImFilterConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Lors de l’envoi de messages instantanés, les utilisateurs peuvent incorporer un URI dans le texte d’un message pour proposer aux autres participants de la conversation un site Web ou un partage 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 Get-CsImFilterConfiguration récupère tous les paramètres concernant le filtrage des URI dans les messages instantanés. Appelée seule (sans aucun paramètre), Get-CsImFilterConfiguration retourne tous les paramètres de filtrage des URI dans les messages instantanés, de manière globale et pour tous les sites. Vous pouvez également spécifier une identité pour afficher uniquement les paramètres d’un site spécifique (ou les 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 Get-CsImFilterConfiguration : 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-CsImFilterConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique des paramètres que vous souhaitez récupérer. Il sera « global » ou « site:<nom du site> », où <nom du site> est le nom du site auquel appliquer ces paramètres, tel que site:Redmond. Type de données complet : Microsoft.Rtc.Management.Xds.XdsIdentity |
Filter |
Facultatif |
Chaîne |
Effectue une recherche par caractères génériques des configurations correspondant à un modèle d’identité donné. Par exemple, retourne tous les paramètres dont les identités commencent par site* (tous les paramètres spécifiques au site). |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait la configuration du filtre de messagerie instantanée à partir du réplica local du magasin central de gestion, et non du magasin central de gestion lui-même. |
Types d’entrées
Aucun.
Types de retours
Get-CsImFilterConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ImFilter.ImFilterConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsImFilterConfiguration
La commande présentée ci-dessus renvoie une collection de tous les filtres de liens hypertexte de messagerie instantanée configurés pour être utilisés dans votre organisation. Il s’agit du comportement par défaut chaque fois que vous appelez Get-CsImFilterConfiguration sans paramètre supplémentaire.
-------------------------- Exemple 2 --------------------------
Get-CsImFilterConfiguration -Identity site:Redmond
L’exemple ci-dessus retourne les paramètres d’un filtre de messagerie instantanée : les paramètres 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-CsImFilterConfiguration -Filter site:*
L’exemple 3 utilise le paramètre Filter pour retourner une collection de tous les filtres de messagerie instantanée qui ont été configurés au niveau du site. La chaîne à caractère générique site:* demande à Get-CsImFilterConfiguration de retourner uniquement les configurations de filtre de messagerie instantanée dont l’identité commence par la valeur de chaîne site:.
-------------------------- Exemple 4 --------------------------
(Get-CsImFilterConfiguration -Identity Global).Prefixes
Dans l’exemple 4, la valeur de la propriété Prefixes de la configuration globale du filtre de messagerie instantanée est « développée » lorsqu’elle est affichée à l’écran ; cela signifie simplement que la propriété et ses valeurs sont affichées dans un format plus convivial et plus lisible. Pour effectuer cette tâche, Get-CsImFilterConfiguration est tout d’abord utilisée pour récupérer la configuration globale du filtre de messagerie instantanée. (Notez que l’appel de Get-CsImFilterConfiguration est placé entre parenthèses. Ceci indique à Windows PowerShell d’exécuter d’abord la commande entre parenthèses, puis de continuer à partir de là.) Une fois la configuration récupérée, la valeur de la propriété Prefixes s’affiche avec un préfixe sur chaque ligne.
Voir aussi
Autres ressources
New-CsImFilterConfiguration
Remove-CsImFilterConfiguration
Set-CsImFilterConfiguration