New-CsAddressBookConfiguration
Dernière rubrique modifiée : 2012-03-23
Crée une nouvelle collection de paramètres de configuration de carnet d’adresses.
Syntaxe
New-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-InMemory <SwitchParameter>] [-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 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 de l’utilisateur et la fréquence de génération des fichiers d’index des carnets d’adresses. Quand vous installez Lync Server, un jeu de paramètres est créé automatiquement pour le carnet d’adresses global. Vous pouvez également créer des paramètres de configuration personnalisés qui peuvent être appliqués à 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.
Les paramètres au niveau du site se créent à l’aide de la cmdlet New-CsAddressBookConfiguration. Vous ne pouvez créer de paramètres qu’au niveau de l’étendue Site. Toute tentative de créer des paramètres à un autre endroit, y compris au niveau de l’étendue globale, sera vouée à l’échec. Votre commande échouera également si le site en question contient une collection de paramètres de carnet d’adresses.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsAddressBookConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique à affecter à la nouvelle collection de paramètres de carnet d’adresses. Puisque vous ne pouvez créer que de nouvelles collections dans l’étendue du site, l’identité sera toujours le préfixe « site: » suivi du nom du site, par exemple « site:Redmond ». |
EnableFileGeneration |
Facultatif |
Paramètre de commutateur |
Si la valeur est True (valeur par défaut) le serveur de carnet d’adresses génère des fichiers d’index de carnet d’adresses téléchargeables par les clients. Si la valeur est False, les fichiers index ne sont pas générés. Les applications clientes devront ainsi utiliser le service de requête sur le Web du carnet d’adresses quand ils recherchent un contact. |
IgnoreGenericRules |
Facultatif |
Booléen |
Indique si le serveur de carnet d’adresses doit ignorer 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 intégrées dans 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 à votre 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 |
Entier |
Spécifie la durée (en jours) pendant laquelle ces serveurs de carnet d’adresses conserveront les fichiers de détail. Les fichiers de détails plus anciens que la valeur de la propriété KeepDuration seront supprimés. KeepDuration peut être défini sur un entier entre 1 et 90 inclus. La valeur par défaut est 30 jours. |
MaxDeltaFileSizePercentage |
Facultatif |
Entier |
En cas de modifications à Active Directory (comme par exemple l’activation d’un nouvel utilisateur pour Lync Server), le serveur de carnet d’adresses enregistrera automatiquement ces changements dans un fichier Delta, composé uniquement des informations mises à jour. Lync 2010 peut alors télécharger les fichiers Delta plutôt que le fichier de carnet d’adresses entier. La propriété MaxDeltaFileSizePercentage détermine la taille maximale des fichiers Delta intégrés dans le fichier de carnet d’adresses complet. Par défaut, la taille des fichiers Delta peut aller jusqu’à 20 % du fichier de carnet d’adresses complet avant qu’un nouveau fichier de carnet d’adresses soit créé. Ainsi, les clients Lync téléchargeront le fichier de carnet d’adresses complet au lieu d’un fichier delta. La valeur MaxDeltaFileSizePercentage doit être saisie comme pourcentage, de 1 à 100 inclus. |
RunTimeOfDay |
Facultatif |
DateTime |
Indique l’heure de la journée à laquelle les serveurs génèrent les 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. SynchronizePollingInterval peut être défini sur toute valeur comprise entre 5 secondes et (00:00:05) et 3 heures (03:00:00). La valeur par défaut est de 5 minutes (1:05:00). |
UseNormalizationRules |
Facultatif |
Booléen |
Indique si les serveurs de carnet d’adresses doivent utiliser leurs règles de normalisation quand ils récupèrent 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. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsAddressBookConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsAddressBookConfiguration -Identity site:Redmond -KeepDuration 15 -SynchronizePollingInterval 00:10:00
L’exemple précédent crée une nouvelle collection de paramètres de configuration de carnet d’adresses avec l’identité site:Redmond. Pour créer la nouvelle collection, vous devez appeler la cmdlet New-CsAddressBookConfiguration ainsi que le paramètre d’identité et les autres paramètres facultatifs (par exemple, KeepDuration et SynchronizePollingInterval).
-------------------------- Exemple 2 --------------------------
$x = Get-CsAddressBookConfiguration -Identity site:Redmond
New-CsAddressBookConfiguration -Identity site:Paris -KeepDuration $x.KeepDuration -SynchronizePollingInterval $x.SynchronizePollingInterval
L’exemple 2 crée une nouvelle collection de paramètres de carnet d’adresses pour le site:Paris. Cette nouvelle collection utilise deux valeurs (KeepDuration et SynchronizePollingInterval) copiées depuis les paramètres du carnet d’adresses configurés pour le site Redmond. Pour ce faire, la commande appelle d’abord Get-CsAddressBookConfiguration pour retourner une collection de tous les paramètres de carnet d’adresses configurés pour le site Redmond. Cette information est stockée dans une variable nommée $x.
La deuxième commande utilise ensuite New-CsAddressBookConfiguration pour créer des paramètres de carnet d’adresses pour le site Paris. Cette commande comprend deux paramètres facultatifs -- KeepDuration et SynchronizePollingInterval-- qui incluent les valeurs copiées à partir de site:Redmond. Par exemple, KeepDuration utilise la valeur de paramètre $x.KeepDuration. Cette valeur de paramètre représente l’information KeepDuration copiée à partir du site Redmond.
-------------------------- Exemple 3 --------------------------
$x = New-CsAddressBookConfiguration -Identity site:Redmond -InMemory
$x.KeepDuration = 15
$x.SynchronizePollingInterval = "00:10:00"
Set-CsAddressBookConfiguration -Instance $x
L’exemple 3 montre comment utiliser le paramètre InMemory pour créer une instance de la collection des paramètres du carnet d’adresses en mémoire uniquement, modifier ces paramètres en mémoire, puis utiliser Set-CsAddressBookConfiguration pour créer une collection réelle avec l’identité site:Redmond. Pour ce faire, la première commande crée une instance en mémoire uniquement de la configuration des paramètres de carnet d’adresses en la stockant avec une variable appelée $x. Le paramètre InMemory garantit que les paramètres du carnet d’adresses n’existeront qu’en mémoire. S’il vous mettez fin à votre session Windows PowerShell ou supprimez la variable $x, les paramètres disparaîtront et ne seront jamais appliqués au site Redmond.
Dans les commandes 2 et 3, deux propriétés de ces paramètres de carnet d’adresses virtuels sont modifiées : La commande 2 fixe la valeur de la propriété KeepDuration à 15 jours et la commande 3 règle l’intervalle SynchronizePollingInterval sur 10 minutes (00:10:00). La quatrième et dernière commande utilise ensuite Set-CsAddressBookConfiguration et le paramètre d’instance pour transformer les paramètres virtuels du carnet d’adresses en une collection réelle de paramètres configurés au niveau du site Redmond.
Voir aussi
Autres ressources
Get-CsAddressBookConfiguration
Remove-CsAddressBookConfiguration
Set-CsAddressBookConfiguration