Partager via

  • Article

Set-CsAddressBookConfiguration

 

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

Modifie une collection de paramètres de configuration du carnet d’adresses.

Syntaxe

Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsAddressBookConfiguration [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-Instance <PSObject>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les serveurs de carnet d’adresses sont des intermédiaires entre AD DS et Microsoft Lync Server 2010. Le serveur de carnet d’adresses veille à ce que les informations utilisateur stockées dans Lync Server 2010 soient synchronisées avec celles qui sont stockées dans AD DS. Pour ce faire, les fichiers de carnet d’adresses sont régulièrement synchronisés avec les informations contenues dans la base de données utilisateur.

De plus, les serveurs de carnet d’adresses génèrent régulièrement des fichiers d’index qui sont téléchargés vers des ordinateurs dotés de Lync 2010. Lorsqu’un utilisateur recherche des contacts, il parcourt généralement les fichiers d’index ou les fichiers d’index de carnet d’adresses stockés dans le magasin central de gestion.

Les serveurs de carnet d’adresses sont régis par les paramètres de configuration du carnet d’adresses. Ces derniers déterminent certains facteurs, tels que la fréquence de synchronisation des serveurs de carnet d’adresses avec la base de données utilisateur et la fréquence de génération des fichiers d’index des carnets d’adresses. Lorsque vous installez Lync Server, un ensemble de paramètres globaux de carnet d’adresses est créé à votre place. Vous pouvez également créer des paramètres de configuration personnalisés afin de les appliquer à des sites individuels. Ces paramètres, s’ils existent, s’appliquent à tous les serveurs de carnet d’adresses opérant sur le site et ont toujours priorité sur les paramètres globaux.

La cmdlet Set-CsAddressBookConfiguration vous permet de modifier les paramètres de configuration du carnet d’adresses utilisés dans votre organisation.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique affecté à la collection des paramètres du carnet d’adresses. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Vous ne pouvez pas utiliser de caractères génériques pour spécifier une identité.

Si ce paramètre est omis, Set-CsAddressBookConfiguration modifie les paramètres globaux.

Instance

Obligatoire

Objet AddressBookSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

EnableFileGeneration

Facultatif

Paramètre de commutateur

Lorsqu’il est défini sur True (valeur par défaut), le serveur de carnet d’adresses génère des fichiers d’index de carnet d’adresses qui peuvent être téléchargés par les clients. Lorsqu’il est défini sur False, les fichiers d’index ne sont pas générés. Cela signifie que les applications clientes devront utiliser le service de requête sur le Web du carnet d’adresses pour la recherche de contacts.

IgnoreGenericRules

Facultatif

Booléen

Indique si le serveur de carnet d’adresses ignore ou non les règles de normalisation génériques utilisées pour analyser les numéros de téléphone. Les règles génériques sont les règles qui sont intégrées à Lync Server 2010. Il n’est pas possible de modifier ces règles. Cependant, en définissant la valeur de cette propriété sur True, vous pouvez indiquer à vos serveurs de carnet d’adresses d’ignorer ces règles et d’utiliser à la place les règles personnalisées que vous créez. La valeur par défaut est False.

KeepDuration

Facultatif

TimeSpan

Spécifie la durée (en jours) pendant laquelle les serveurs de carnet d’adresses conserveront ces fichiers de modification. Les fichiers de modification antérieurs à la valeur de la propriété KeepDuration seront supprimés. Ce paramètre peut être défini sur un entier compris entre 1 et 90 inclus. La valeur par défaut est 30 jours.

MaxDeltaFileSizePercentage

Facultatif

Entier

Lorsque des modifications sont apportées à Active Directory (un nouvel utilisateur activé pour Lync Server, par exemple), le serveur de carnet d’adresses enregistre en général ces modifications dans un « fichier delta », c’est-à-dire un fichier comportant uniquement les informations mises à jour ; Lync 2010 peut alors télécharger les fichiers delta au lieu d’un fichier de carnet d’adresses complet. La propriété MaxDeltaFileSizePercentage détermine la taille que doivent atteindre les fichiers delta pour être incorporés dans le fichier de carnet d’adresses. Par défaut, la taille des fichiers delta doit atteindre 20 pour cent de la taille du fichier de carnet d’adresses complet pour qu’un nouveau fichier de carnet d’adresses soit généré. Lorsque c’est le cas, les clients Lync téléchargeront le fichier de carnet d’adresses complet au lieu d’un fichier delta.

La valeur de la propriété MaxDeltaFileSizePercentage doit être un pourcentage compris entre 1 et 100.

RunTimeOfDay

Facultatif

DateTime

Indique l’heure à laquelle les serveurs génèrent de nouveaux fichiers de carnet d’adresses. La propriété RunTimeOfDay est basée sur le format 24 heures (heures:minutes:secondes), 00:00:00 représentant minuit et 23:59:00 représentant 23 h 59.

La valeur par défaut est 01:30:00.

SynchronizePollingInterval

Facultatif

TimeSpan

Indique la fréquence à laquelle les serveurs de carnet d’adresses synchronisent leurs informations avec les informations conservées dans la base de données utilisateur. Le paramètre SynchronizePollingInterval peut être défini sur n’importe quelle valeur comprise entre 5 secondes (00:00:05) et 3 heures (03:00:00). La valeur par défaut est 5 minutes (00:05:00).

UseNormalizationRules

Facultatif

Booléen

Indique si les serveurs de carnet d’adresses doivent utiliser les règles de normalisation des numéros de téléphone pour extraire des numéros de téléphone. Si la valeur est False, les numéros de téléphone seront extraits tels quels et l’application cliente devra appliquer des règles de normalisation pour les afficher.

La valeur par défaut est True.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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.AddressBook.AddressBookSettings. Set-CsAddressBookConfiguration accepte la saisie de données transmises via le pipeline pour les objets de configuration du carnet d’adresses.

Types de retours

Set-CsAddressBookConfiguration ne retourne aucune valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Exemple

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

Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00

Cet exemple définit la propriété RunTimeOfDay, c’est-à-dire la propriété qui détermine l’heure à laquelle la synchronisation du carnet d’adresses a lieu, sur 23:00. Le paramètre Identity est utilisé pour limiter la modification aux paramètres de configuration du carnet d’adresses ayant l’identité site:Redmond.

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

Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00

Dans l’exemple 2, la propriété RunTimeOfDay est définie sur 23:00 pour toutes les collections de paramètres de carnet d’adresses configurées au niveau de l’étendue Site. Pour cela, la commande utilise la cmdlet Get-CsAddressBookConfiguration et le paramètre Filter pour retourner une collection de tous les paramètres spécifiques au site ; la valeur de filtre « site:* » limite les résultats aux collection configurées au niveau de l’étendue Site. Ces informations sont ensuite redirigées vers la cmdlet Set-CsAddressBookConfiguration, qui modifie la valeur de la propriété RunTimeOfDay pour chaque élément de la collection.

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

Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30} | Set-CsAddressBookConfiguration -KeepDuration 30

La commande précédente modifie la propriété KeepDuration pour les collections de paramètres de carnet d’adresses lorsque cette propriété indique une valeur inférieure à 30 jours. Pour effectuer cette tâche, la cmdlet Get-CsAddressBookConfiguration est utilisée sans paramètres supplémentaires. Ainsi, une collection de tous les paramètres de carnet d’adresses configurés en vue d’une utilisation dans l’organisation est retournée. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les paramètres pour lesquels la propriété KeepDuration est inférieure à 30 jours. Cette collection filtrée est ensuite redirigée vers la cmdlet Set-CsAddressBookConfiguration qui applique la valeur 30 jours à la propriété KeepDuration pour chaque élément de la collection.