Partager via

  • Article

Remove-CsAddressBookConfiguration

 

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

Supprime la collection spécifiée de paramètres de configuration de carnet d'adresses.

Syntaxe

Remove-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. 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 New-CsAddressBookConfiguration vous permet de créer des paramètres de configuration de carnet d’adresses au niveau du site. Pour supprimer ultérieurement des paramètres de carnet d'adresses que vous avez définis dans l'étendue Site, utilisez la cmdlet Remove-CsAddressBookConfiguration. Notez que vous pouvez également exécuter Remove-CsAddressBookConfiguration sur les paramètres globaux ; néanmoins, les paramètres globaux ne peuvent pas être supprimés. Par contre, vous pouvez exécuter Remove-CsAddressBookConfiguration sur les paramètres globaux pour rétablir les valeurs par défaut de toutes les propriétés globales.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la collection de paramètres de configuration de carnet d'adresses à supprimer. Pour supprimer la collection globale, utilisez la syntaxe suivante : -Identity global. (Lorsque vous "supprimez" les paramètres globaux, vous remettez simplement toutes les propriétés sur leur valeur par défaut.) Pour supprimer une collection de sites, utilisez une syntaxe semblable à ceci : -Identity site:Redmond. Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez l’identité d’une stratégie.

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

Types de retours

Remove-CsAddressBookConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet supprime les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Exemple

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

Remove-CsAddressBookConfiguration -Identity site:Redmond

Dans cet exemple, Remove-CsAddressBookConfiguration permet de supprimer les paramètres de configuration de carnet d'adresses dont l'identité est site:Redmond. L'utilisation du paramètre Identity permet de s'assurer que seuls les paramètres de carnet d'adresses spécifié seront supprimés.

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

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

Dans l'exemple 2, toutes les collections de paramètres de carnet d'adresse configurées dans l'étendue Site sont supprimées. Pour effectuer cette opération, la cmdlet Get-CsAddressBookConfiguration récupère une collection de tous les paramètres de carnet d'adresses qui ont été définis dans l'étendue Site. Utilisez pour cela le paramètre Filter et la valeur de filtre "site:*". La collection extraite est ensuite redirigée vers la cmdlet Remove-CsAddressBookConfiguration, qui supprime tous les éléments présents dans cette collection.

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

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

La commande précédente supprime tous les paramètres de carnet d'adresses dans lesquels les fichiers modifiés sont conservés pendant moins de 30 jours. Pour effectuer cette tâche, Get-CsAddressBookConfiguration retourne une collection de tous les paramètres de carnet d'adresses actuellement utilisés dans l'organisation. Cette collection est ensuite redirigée vers Where-Object, qui sélectionne uniquement les paramètres pour lesquels la propriété KeepDuration est inférieure à 30 jours. (Notez la syntaxe : 30., avec un point suivant le nombre de jours.) Enfin, la collection filtrée est redirigée vers Remove-CsAddressBookConfiguration qui supprime chaque élément contenu dans cette collection.