New-OfflineAddressBook (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
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> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
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éé. |
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]. |
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. |
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"