New-OfflineAddressBook
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2008-01-21
La cmdlet New-OfflineAddressBook permet de créer un carnet d'adresses en mode hors connexion.
Syntaxe
New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet New-OfflineAddressBook permet aux administrateurs de créer un carnet d'adresses en mode hors connexion. Par exemple, si vous désinstallez un serveur d'accès au client contenant un carnet d'adresses en mode hors connexion, vous devez le re-créer sur un autre serveur d'accès au client.
Pour exécuter la cmdlet New-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 Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
AddressLists |
Obligatoire |
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. |
Name |
Obligatoire |
System.String |
Le paramètre Name spécifie le nom décrivant l'objet carnet d'adresses en mode hors connexion dans le Gestionnaire système Exchange (jusqu'à 64 caractères). |
Server |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Le paramètre Server spécifie le serveur sur lequel le carnet d'adresses en mode hors connexion sera créé. |
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 la durée, en jours, pendant laquelle 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 « Unlimited ». |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour créer le carnet d'adresses en mode hors connexion. |
IsDefault |
Facultatif |
System.Boolean |
Si la valeur du paramètre IsDefault est $true, le carnet d'adresses en mode hors connexion est le carnet d'adresses en mode hors connexion par défaut pour toutes les nouvelles bases de données de boîtes aux lettres. Si la valeur est $false, le carnet d'adresses en mode hors connexion n'est pas le carnet d'adresses en mode hors connexion par défaut. |
PublicFolderDatabase |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Le paramètre PublicFolderDatabase spécifie l'identité d'une base de données de dossiers publics. |
PublicFolderDistributionEnabled |
Facultatif |
System.Boolean |
Si la valeur du paramètre PublicFolderDistributionEnabled est |
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]. |
SkipPublicFolderInitialization |
Facultatif |
System.Management.Automation.SwitchParameter |
Si vous créez un carnet d'adresses en mode hors connexion qui utilise la distribution de dossiers publics, utilisez le paramètre SkipPublicFolderInitialization pour ignorer la création immédiate des dossiers publics du carnet d'adresses en mode hors connexion. Le carnet d'adresses en mode hors connexion ne sera pas disponible pour téléchargement jusqu'à l'exécution du cycle suivant de maintenance des dossiers de site. Il n'est pas nécessaire de spécifier une valeur pour le paramètre SkipPublicFolderInitialization. L'omission de ce paramètre peut entraîner la pause de la tâche alors que celle-ci contacte le serveur de dossiers publics responsable de la création des dossiers publics requis. Si le serveur est inaccessible ou que le contact du serveur constitue une opération coûteuse, la pause peut durer longtemps. |
TemplateInstance |
Facultatif |
System.Management.Automation.PSObject |
Le paramètre TemplateInstance spécifie le modèle utilisé pour créer le carnet d'adresses en mode hors connexion. |
Versions |
Facultatif |
System.Collections.ObjectModel.Collection |
Le paramètre Versions spécifie la version du carnet d'adresses en mode hors connexion à générer. Les valeurs autorisées sont les suivantes :
|
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 utilise deux commandes pour créer un carnet d'adresses en mode hors connexion nommé OfflineAddressBook incluant toutes les listes d'adresses disponibles dans l'organisation. Avec les paramètres affichés, un carnet d'adresses en mode hors connexion est généré par myserver.contoso.com les lundi et mercredi entre 1h00 et 2h00. La commande crée également le carnet d'adresses en mode hors connexion par défaut pour l’organisation.
$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"