New-OfflineAddressBook
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
Utilisez l’applet de commande New-OfflineAddressBook pour créer des carnets d’adresses en mode hors connexion.
Dans Exchange Online, cette applet de commande est disponible uniquement dans le rôle Listes d’adresses et, par défaut, le rôle n’est attribué à aucun groupe de rôles. Pour utiliser cette applet de commande, vous devez ajouter le rôle Listes d’adresses à un groupe de rôles (par exemple, au groupe de rôles Gestion de l’organisation). Pour plus d'informations, consultez la section relative à l'Ajouter un rôle à un groupe de rôles.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
New-OfflineAddressBook
[-Name] <String>
-AddressLists <AddressBookBaseIdParameter[]>
[-Confirm]
[-DiffRetentionPeriod <Unlimited>]
[-DomainController <Fqdn>]
[-GeneratingMailbox <MailboxIdParameter>]
[-GlobalWebDistributionEnabled <Boolean>]
[-IsDefault <Boolean>]
[-PublicFolderDatabase <DatabaseIdParameter>]
[-PublicFolderDistributionEnabled <Boolean>]
[-Schedule <Schedule>]
[-Server <ServerIdParameter>]
[-ShadowMailboxDistributionEnabled <Boolean>]
[-SkipPublicFolderInitialization]
[-Versions <MultiValuedProperty>]
[-VirtualDirectories <VirtualDirectoryIdParameter[]>]
[-WhatIf]
[<CommonParameters>] Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
$a = Get-AddressList | Where {$_.Name -Like "*AgencyB*"}
New-OfflineAddressBook -Name "OAB_AgencyB" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"Dans Exchange Server 2010 et 2013, cet exemple utilise deux commandes pour créer le carnet d’adresses en mode hors connexion nommé OAB_AgencyB qui inclut toutes les listes d’adresses dans lesquelles AgencyB fait partie du nom. À l’aide des paramètres indiqués, un carnet d’adresses en mode hors connexion est généré par myserver.contoso.com les lundis et mercredis de 01h00 (1h00) à 02h00 (2h00). Cet exemple de commande crée également le carnet d’adresses en mode hors connexion par défaut pour le organization.
Exemple 2
New-OfflineAddressBook -Name "Contoso Executives OAB" -AddressLists "Default Global Address List","Contoso Executives Address List" -GlobalWebDistributionEnabled $trueCet exemple crée un carnet d’adresses en mode hors connexion nommé Contoso Executives OAB avec les propriétés suivantes :
- Listes d’adresses incluses dans le carnet d’adresses en mode hors connexion : liste d’adresses globale par défaut et liste d’adresses des cadres contoso
- Tous les répertoires virtuels du carnet d’adresses en mode hors connexion dans le organization peuvent accepter des demandes de téléchargement du carnet d’adresses en mode hors connexion.
La boîte aux lettres organization responsable de la génération du carnet d’adresses en mode hors connexion est SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (nous n’avons pas utilisé le paramètre GeneratingMailbox pour spécifier une boîte aux lettres organization différente).
Le carnet d’adresses en mode hors connexion n’est pas utilisé par les boîtes aux lettres et les bases de données de boîtes aux lettres qui n’ont pas de carnet d’adresses en mode hors connexion spécifié (nous n’avons pas utilisé le paramètre IsDefault avec la valeur $true).
Exemple 3
New-OfflineAddressBook -Name "New OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -VirtualDirectories "SERVER01\OAB (Default Web Site)"Dans Exchange Server 2010, cet exemple crée le nouveau carnet d’adresses en mode hors connexion qui utilise la distribution web pour les clients Microsoft Office Outlook 2007 ou ultérieurs sur SERVER01 à l’aide du répertoire virtuel par défaut.
Exemple 4
New-OfflineAddressBook -Name "Legacy OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -PublicFolderDatabase "PFDatabase" -PublicFolderDistributionEnabled $true -Versions Version1,Version2Dans Exchange Server 2010, cet exemple crée le carnet d’adresses en mode hors connexion hérité qui utilise la distribution de dossiers publics pour les clients Outlook 2003 Service Pack 1 (SP1) et Outlook 98 Service Pack 2 (SP2) sur SERVER01.
Si vous configurez les OOB pour utiliser la distribution de dossiers publics, mais que votre organization n’a pas d’infrastructure de dossiers publics, une erreur est retournée. Pour plus d’informations, consultez Gestion des dossiers publics.
Paramètres
-AddressLists
Le paramètre AddressLists spécifie les listes d’adresses ou les listes d’adresses globales qui sont incluses dans le carnet d’adresses en mode hors connexion. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la liste d’adresses. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Vous pouvez trouver les valeurs identifiant les listes d’adresses et les listes d’adresses globales en utilisant les applets de commande Get-AddressList et Get-GlobalAddressList.
| Type: | AddressBookBaseIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DiffRetentionPeriod
Le paramètre DiffRetentionPeriod spécifie le nombre de jours où les fichiers de différence du carnet d’adresses en mode hors connexion sont stockés sur le serveur. Les valeurs valides sont les entiers compris entre 7 pour 1 825, ou la valeur unlimited. La valeur par défaut est de 30.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GeneratingMailbox
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre GeneratingMailbox spécifie la boîte aux lettres d’arbitrage où le carnet d’adresses en mode hors connexion est généré. Plus précisément, la boîte aux lettres d’arbitrage doit contenir la valeur OrganizationCapabilityOABGen pour la propriété PersistedCapability. Les boîtes aux lettres d’arbitrage ayant cette fonctionnalité sont également appelées boîtes aux lettres de l’organisation. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
La valeur par défaut de ce paramètre est la boîte aux lettres de l’organisation nommée SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}.
Une boîte aux lettres de organization unique peut générer plusieurs OOB (vous pouvez utiliser la même valeur pour ce paramètre dans les paramètres de plusieurs OAB), mais dans Exchange 2013 CU5 ou version ultérieure, un carnet d’adresses en mode hors connexion ne peut être généré que par une seule boîte aux lettres organization (ce paramètre n’accepte pas plusieurs valeurs). Pour qu’une copie en lecture seule du carnet d’adresses en mode hors connexion (également appelée cliché instantané) soit disponible dans les autres boîtes aux lettres de l’organisation, utilisez le paramètre ShadowMailboxDistributionEnabled.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GlobalWebDistributionEnabled
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre GlobalWebDistributionEnabled spécifie si tous les répertoires virtuels du carnet d’adresses en mode hors connexion dans l’organisation peuvent accepter les demandes de téléchargement du carnet d’adresses en mode hors connexion. Ces emplacements sont signalés par le service de découverte automatique. Les valeurs valides sont les suivantes :
- $true : tout répertoire virtuel OAB dans le organization peut accepter les demandes de téléchargement du carnet d’adresses en mode hors connexion. Vous ne pouvez pas utiliser cette valeur avec le paramètre VirtualDirectories.
- $false : seuls les répertoires virtuels du carnet d’adresses en mode hors connexion spécifiés par le paramètre VirtualDirectories acceptent les demandes de téléchargement du carnet d’adresses en mode hors connexion. Il s’agit de la valeur par défaut.
Dans Exchange 2013 CU7 ou version ultérieure, nous vous recommandons d’utiliser la valeur $true pour ce paramètre. Les services d’accès aux clients sur un serveur de boîte aux lettres peuvent diriger les demandes entrantes de téléchargement du carnet d’adresses en mode hors connexion vers l’emplacement correct.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsDefault
Le paramètre IsDefault spécifie si le carnet d’adresses en mode hors connexion est utilisé par toutes les boîtes aux lettres et par les bases de données de boîte aux lettres qui n’ont pas de carnet d’adresses en mode hors connexion spécifié. Les valeurs valides sont les suivantes :
- $true : le carnet d’adresses en mode hors connexion est le carnet d’adresses en mode hors connexion par défaut.
- $false : le carnet d’adresses en mode hors connexion n’est pas le carnet d’adresses en mode hors connexion par défaut. Il s’agit de la valeur par défaut.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Le paramètre Name spécifie le nom unique du carnet d’adresses en mode hors connexion. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, mettez le nom entre guillemets.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PublicFolderDatabase
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre PublicFolderDatabase spécifie la base de données de dossiers publics utilisée pour distribuer le carnet d’adresses en mode hors connexion. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Pour utiliser ce paramètre, le paramètre PublicFolderDistributionEnabled doit être défini sur $true.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-PublicFolderDistributionEnabled
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre PublicFolderDistributionEnabled spécifie si le carnet d’adresses en mode hors connexion est distribué via des dossiers publics. Si la valeur du paramètre PublicFolderDistributionEnabled est $true, le carnet d’adresses en mode hors connexion est distribué via des dossiers publics.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Schedule
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre Schedule spécifie l’intervalle de génération du carnet d’adresses en mode hors connexion dans Exchange 2010 ou une version antérieure.
La syntaxe de ce paramètre est : StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM].
Vous pouvez utiliser les valeurs suivantes pour les jours :
- Nom complet du jour.
- Nom abrégé du jour.
- Entier compris entre 0 et 6, où 0 = Dimanche.
Vous pouvez entrer l’heure au format 24 heures et omettre la valeur AM/PM. Si vous entrez l’heure au format 12 heures, incluez un espace entre l’heure et la valeur AM/PM.
Vous pouvez combiner des formats de date/heure.
Les heures de début et de fin doivent être séparées d'au moins 15 minutes. Les minutes sont arrondies à la valeur inférieure (0, 15, 30 ou 45).
Voici quelques exemples :
- "Dim.23:30-Lun.1:30"
- « 6.22:00-6.22:15 » (à partir du samedi à 22h00 jusqu’au samedi à 22h15.)
- « Dim.1:15 AM-Monday.23:00 »
| Type: | Schedule |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Server
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le paramètre Server définit le serveur Exchange sur lequel vous souhaitez exécuter cette commande. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :
- Nom
- FQDN
- Nom unique
- ExchangeLegacyDN
DN Exchange hérité
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-ShadowMailboxDistributionEnabled
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ShadowMailboxDistributionEnabled spécifie si une copie en lecture seule du carnet d’adresses en mode hors connexion (également appelée cliché instantané) est distribuée sur toutes les autres boîtes aux lettres de génération du carnet d’adresses en mode hors connexion (également appelées boîtes aux lettres de l’organisation). Ainsi, les serveurs de boîte aux lettres supplémentaires peuvent être des points de terminaison pour les demandes de téléchargement du carnet d’adresses en mode hors connexion, ce qui permet d’empêcher les utilisateurs de télécharger le carnet d’adresses en mode hors connexion sur les liens WLAN lents. Les valeurs valides sont les suivantes :
- $true : le carnet d’adresses en mode hors connexion est distribué à toutes les autres boîtes aux lettres organization.
- $false : le carnet d’adresses en mode hors connexion n’est pas distribué à d’autres boîtes aux lettres organization. Il s’agit de la valeur par défaut.
La valeur de ce paramètre n’est significative que si vous avez plusieurs boîtes aux lettres organization et n’est utile que dans les organisations Exchange qui ont plusieurs sites Active Directory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SkipPublicFolderInitialization
Ce paramètre n'est disponible que dans Exchange Server 2010.
Le commutateur SkipPublicFolderInitialization spécifie s’il faut ignorer la création immédiate des dossiers publics du carnet d’adresses en mode hors connexion si vous créez un carnet d’adresses en mode hors connexion qui utilise la distribution de dossiers publics. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Le carnet d’adresses en mode hors connexion n’est pas disponible en téléchargement tant que le cycle de maintenance du dossier de site suivant n’est pas terminé. L’omission de ce commutateur peut entraîner l’interruption de la tâche pendant qu’elle contacte le serveur de dossiers publics responsable pour créer les dossiers publics nécessaires. Si le serveur est actuellement inaccessible, ou s’il est autrement coûteux à contacter, la pause peut être importante.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Versions
Ce paramètre n'est disponible que dans Exchange Server 2010.
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 valeurs valides sont les suivantes :
- Version2 (nécessite une distribution de dossiers publics)
- Version3 (nécessite une distribution de dossiers publics)
- Version4 (valeur par défaut)
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-VirtualDirectories
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre VirtualDirectories spécifie les répertoires virtuels du carnet d’adresses en mode hors connexion qui acceptent les demandes de téléchargement du carnet d’adresses en mode hors connexion. Ces emplacements sont signalés dans le service de découverte automatique.
Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique le répertoire virtuel. Par exemple :
- Nom ou Serveur\Nom
- Nom unique
- GUID
La valeur Name utilise la syntaxe "VirtualDirectoryName (WebsiteName)" des propriétés du répertoire virtuel. Vous pouvez spécifier le caractère générique (*) au lieu du site web par défaut à l’aide de la syntaxe VirtualDirectoryName*.
La valeur par défaut de ce paramètre est les services d’accès au client (frontend) et les répertoires virtuels OAB back-end sur le serveur de boîtes aux lettres qui contient la boîte aux lettres de génération OAB (le paramètre GeneratingMailbox ou SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}). Par exemple, Mailbox01\OAB (site web par défaut),Mailbox01\OAB (serveur principal Exchange).
Pour pouvoir utiliser ce paramètre, le paramètre GlobalWebDistributionEnabled doit avoir la valeur $false.
Dans Exchange 2013 CU7 ou version ultérieure, nous vous recommandons de définir le paramètre GlobalWebDistributionEnabled sur $true, car les services d’accès au client sur n’importe quel serveur de boîtes aux lettres peuvent proxyer les demandes de téléchargement OAB entrantes vers l’emplacement approprié.
| Type: | VirtualDirectoryIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.