Set-OfflineAddressBook
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-07-05
La cmdlet Set-OfflineAddressBook permet de modifier les paramètres d'un carnet d'adresses en mode hors connexion.
Syntaxe
Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Set-OfflineAddressBook [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-Instance <OfflineAddressBook>] [-IsDefault <$true | $false>] [-Name <String>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Set-OfflineAddressBook modifie les paramètres d'un carnet d'adresses en mode hors connexion existant. Un carnet d'adresses en mode hors connexion est outil précieux pour les utilisateurs qui passent un temps important déconnectés du réseau. Un carnet d'adresses en mode hors connexion est un instantané d'une ou plusieurs listes d'adresses que les clients MAPI peuvent télécharger pour offrir un accès aux listes d'adresses en mode hors connexion.
La génération d'un carnet d'adresses en mode hors connexion ne s'interrompt pas même s'il faut plus de temps que celui spécifié dans le paramètre Schedule.
Pour exécuter la cmdlet Set-OfflineAddressBook, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter |
Le paramètre Identity permet de spécifier le GUID, le nom unique ou le nom de carnet d'adresses en mode hors connexion représentant un carnet d'adresses en mode hors connexion spécifique. Vous pouvez également inclure le chemin d'accès en utilisant le format Serveur\Nom_carnet_adresses_en_mode_hors_connexion. Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de carnet d'adresses en mode hors connexion ou le GUID. |
AddressLists |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
Le paramètre AddressLists spécifie un tableau d'identités de liste d'adresses incluses dans le carnet d'adresses en mode hors connexion. |
ApplyMandatoryProperties |
Facultatif |
System.Management.Automation.SwitchParameter |
La création d'un carnet d'adresses en mode hors connexion Exchange 2007 via le Gestionnaire système Exchange Server 2003 Exchange n'est pas prise en charge. Si un carnet d'adresses en mode hors connexion Exchange 2007 est créé à l'aide de cet outil, il est identifié comme carnet d'adresses en mode hors connexion hérité même s'il réside sur un serveur Exchange 2007. Le paramètre ApplyMandatoryProperties permet de modifier les propriétés obligatoires d’un carnet d'adresses en mode hors connexion dans cet état afin de résoudre le problème. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm. |
DiffRetentionPeriod |
Facultatif |
System.Nullable |
Le paramètre DiffRetentionPeriod spécifie le temps, en jours, pendant lequel les fichiers de différences du carnet d'adresses en mode hors connexion sont conservés sur le serveur générant le carnet d'adresses en mode hors connexion et le serveur d'accès au client. Pour conserver les fichiers de différences du carnet d'adresses en mode hors connexion indéfiniment, utilisez la valeur Illimitée. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OfflineAddressBook |
Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. |
IsDefault |
Facultatif |
System.Boolean |
Le paramètre IsDefault définit ce carnet d'adresses en mode hors connexion comme carnet d'adresses en mode hors connexion par défaut pour toutes les nouvelles banques de boîtes aux lettres. |
Name |
Facultatif |
System.String |
Le paramètre Name définit le nouveau nom du carnet d'adresses en mode hors connexion. Le nom s'affiche dans la console de gestion Exchange. La valeur d'un paramètre Name peut compter jusqu'à 64 caractères. |
PublicFolderDistributionEnabled |
Facultatif |
System.Boolean |
La définition du paramètre PublicFolderDistributionEnabled sur $true a pour effet que le carnet d'adresses en mode hors connexion est distribué via des dossiers publics. La valeur par défaut est $true. |
Schedule |
Facultatif |
Microsoft.Exchange.Data.Schedule |
Le paramètre Schedule spécifie l'intervalle planifié pour la génération de carnet d'adresses en mode hors connexion. Le paramètre Schedule prend le format suivant et doit inclure une plage : Jour.Heure:Minute [AM/PM]-Jour.Heure:Minute [AM/PM]. |
Versions |
Facultatif |
System.Collections.ObjectModel.Collection |
Le paramètre Versions spécifie les versions de carnet d'adresses en mode hors connexion générées pour le téléchargement du client. Les options disponibles sont Version4, Version3 et Version2. Version4 est destinée à Microsoft Office Outlook 2007 ou aux clients Office Outlook 2003 Service Pack 2 (SP2). Version3 est destiné aux clients Outlook qui prennent en charge Unicode. Version2 est destinée aux clients Microsoft Exchange Server 2007, Exchange 2003, Exchange 2000 Server et Exchange Server version 5.5. |
VirtualDirectories |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
Le paramètre VirtualDirectories spécifie le tableau d'objets OABVirtualDirectory. Si le paramètre VirtualDirectories est spécifié, vous devez générer la Version4 du carnet d'adresses en mode hors connexion. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Cet exemple modifie le nom du carnet d'adresses en mode hors connexion.
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -Name "My Offline Address Book"