Set-OfflineAddressBook

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-07-19

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Set-OfflineAddressBook permet de modifier les paramètres d'un carnet d'adresses en mode hors connexion.

Par défaut dans Exchange Online, le rôle de liste d’adresses n’est affecté à aucun groupe de rôles. Pour utiliser les cmdlets nécessitant le rôle Liste d’adresses, vous devez ajouter ce dernier à un groupe de rôles. Pour plus d’informations, consultez la section « Ajouter un rôle à un groupe de rôles » de la rubrique Gérer des groupes de rôles.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Set-OfflineAddressBook -Identity <OfflineAddressBookIdParameter> [-AddressLists <AddressBookBaseIdParameter[]>] [-ApplyMandatoryProperties <SwitchParameter>] [-ConfiguredAttributes <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Unlimited>] [-DomainController <Fqdn>] [-FullOabDownloadPreventionThreshold <Int32>] [-GeneratingMailbox <MailboxIdParameter>] [-GlobalWebDistributionEnabled <$true | $false>] [-HttpHomeMdbLastProcessedBucket <Int32>] [-IsDefault <$true | $false>] [-MaxBinaryPropertySize <Int32>] [-MaxMultivaluedBinaryPropertySize <Int32>] [-MaxMultivaluedStringPropertySize <Int32>] [-MaxStringPropertySize <Int32>] [-Name <String>] [-Schedule <Schedule>] [-ShadowMailboxDistributionEnabled <$true | $false>] [-UpgradeFromE14 <SwitchParameter>] [-UseDefaultAttributes <SwitchParameter>] [-Versions <MultiValuedProperty>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Cet exemple configure le carnet d’adresses en mode hors connexion par défaut de sorte qu’il soit disponible pour les demandes de téléchargement à partir de tous les répertoires virtuels de carnet d’adresses en mode hors connexion dans l’organisation.

Set-OfflineAddressBook -Identity "Default Offline Address Book" -VirtualDirectories $null
Set-OfflineAddressBook -Identity "Default Offline Address Book" -GlobalWebDistributionEnabled $true

Cet exemple modifie la boîte aux lettres de l’organisation qui est chargée de la génération du carnet d’adresses en mode hors connexion.

Set-OfflineAddressBook -Identity "\Default Offline Address Book" -GeneratingMailbox OABGen2

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 nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Paramètre Requis Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

Le paramètre Identity permet de définir le carnet d’adresses en mode hors connexion à modifier. Vous pouvez utiliser n’importe quelle valeur permettant de l’identifier de manière unique. Par exemple :

  • Nom ou \Nom

  • Nom unique (DN)

  • GUID

AddressLists

Facultatif

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

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 une valeur quelconque qui identifie la liste d’adresses. Par exemple :

  • Nom

  • Nom unique (DN)

  • GUID

Pour saisir plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

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.

ApplyMandatoryProperties

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur ApplyMandatoryProperties indique si les propriétés obligatoires d’un carnet d’adresses en mode hors connexion hérité doivent être mises à jour. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur a été utilisé dans les environnements de coexistence lors de la migration d’un carnet d’adresses en mode hors connexion à partir de Exchange 2003.

ConfiguredAttributes

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConfiguredAttributes spécifie les propriétés MAPI de destinataire qui sont disponibles dans le carnet d’adresses en mode hors connexion. Ce paramètre utilise la syntaxe suivante : "<Name1>,<Type1>","<Name2>,<Type2>"..., où <Name> est le nom de la propriété MAPI (par exemple, MobileTelephoneNumber), et <Type> est la valeur ANR (résolution des noms ambigus), Value ou Indicator.

Pour saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

Pour rétablir les valeurs par défaut de ce paramètre, utilisez le commutateur UseDefaultAttributes.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DiffRetentionPeriod

Facultatif

Microsoft.Exchange.Data.Unlimited

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

FullOabDownloadPreventionThreshold

Facultatif

System.Int32

PARAMVALUE : Int32

GeneratingMailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • 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 d’organisation unique peut générer plusieurs carnets d’adresses en mode hors connexion (vous pouvez utiliser la même valeur dans les paramètres de plusieurs carnets d’adresses en mode hors connexion), mais dans Exchange 2013 CU5 ou version ultérieure, un carnet d’adresses en mode hors connexion peut être généré uniquement par une boîte aux lettres de l’organisation unique (ce paramètre n’accepte pas les valeurs multiples). 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.

GlobalWebDistributionEnabled

Facultatif

System.Boolean

Ce paramètre est disponible uniquement dans Exchange 2016 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 de carnet d’adresses en mode hors connexion dans l’organisation peut accepter des 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 de carnet d’adresses en mode hors connexion spécifiés par le paramètre VirtualDirectories peuvent accepter ces demandes de téléchargement. 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.

HttpHomeMdbLastProcessedBucket

Facultatif

System.Int32

Ce paramètre est réservé à l’usage interne chez Microsoft.

IsDefault

Facultatif

System.Boolean

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 celui par défaut.

  • $false   Le carnet d’adresses en mode hors connexion n’est pas celui par défaut.

MaxBinaryPropertySize

Facultatif

System.Int32

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre MaxBinaryPropertySize spécifie la taille maximale en octets des attributs binaires dans le carnet d’adresses en mode hors connexion avant qu’ils soient tronqués. Les valeurs valides sont les entiers compris entre 0 et 999 999 999. La valeur par défaut est 65 536.

MaxMultivaluedBinaryPropertySize

Facultatif

System.Int32

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre MaxMultivaluedBinaryPropertySize spécifie la taille maximale en octets des attributs binaires à valeurs multiples dans le carnet d’adresses en mode hors connexion avant qu’ils soient tronqués. Les valeurs valides sont les entiers compris entre 0 et 999 999 999. La valeur par défaut est 65 536 (64 kilo-octets).

MaxMultivaluedStringPropertySize

Facultatif

System.Int32

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre MaxMultivaluedStringPropertySize spécifie la taille maximale des attributs de chaîne à valeurs multiples dans le carnet d’adresses en mode hors connexion avant qu’ils soient tronqués. Les valeurs valides sont les entiers compris entre 0 et 999 999 999. La valeur par défaut est 65 536 (64 kilo-octets).

MaxStringPropertySize

Facultatif

System.Int32

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre MaxStringPropertySize spécifie la taille maximale en octets des attributs de chaîne avant qu’ils soient tronqués. Les valeurs valides sont les entiers compris entre 0 et 999 999 999. La valeur par défaut est 3 400.

Name

Facultatif

System.String

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.

Schedule

Facultatif

Microsoft.Exchange.Data.Schedule

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Remarque : Dans Exchange 2013 ou version ultérieure, ce paramètre n’est plus responsable de la planification de la génération du carnet d’adresses en mode hors connexion. Pour plus d’informations, voir Modifier la planification de génération du carnet d’adresses en mode hors connexion dans Exchange 2016.

Le paramètre Schedule spécifie l’intervalle pour la génération de carnet d’adresses en mode hors connexion dans Exchange 2010 ou version ultérieure.

Les valeurs suivantes peuvent être utilisées pour les jours de début et de fin :

  • Nom complet du jour

  • Nom abrégé du jour

  • Entier compris entre 0 et 6, où 0 = Dimanche

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. Si vous spécifiez plusieurs intervalles, ils doivent être séparés d'au moins 15 minutes les uns des autres.

Les éléments suivants sont des exemples :

  • "Dim.23:30-Lun.1:30"

  • 6.22:00-6.22:15 (l’assistant sera exécuté du samedi à 22:00 au samedi à 22:15)

  • "Lundi.4:30-Lundi.5:30","Mercredi.4:30-Mercredi.5:30" (l’assistant sera exécuté les lundi et mercredi matins de 4:30 à 5:30)

  • "Sun.1:15 AM-Monday.23:00"

Remarque : dans Office 365, la valeur en lecture seule de cette propriété est affichée au format UTC (temps universel coordonné).

ShadowMailboxDistributionEnabled

Facultatif

System.Boolean

Ce paramètre est disponible uniquement dans Exchange 2016 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é sur toutes les autres boîtes aux lettres de l’organisation.

  • $false   Le carnet d’adresses en mode hors connexion n’est pas distribué sur les autres boîtes aux lettres de l’organisation. Il s’agit de la valeur par défaut.

La valeur de ce paramètre est pertinente uniquement si vous avez plusieurs boîtes aux lettres de l’organisation, et présente un intérêt uniquement pour les organisations Exchange qui disposent de plusieurs sites Active Directory.

UpgradeFromE14

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

UseDefaultAttributes

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur UseDefaultAttributes indique si les propriétés MAPI de destinataire qui sont disponibles dans le carnet d’adresses en mode hors connexion doivent être rétablies sur la liste par défaut. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour annuler les modifications que vous avez apportées à la liste par défaut à l’aide du paramètre ConfiguredAttributes.

Versions

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

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. Dans Exchange 2013 ou version ultérieure, la valeur par défaut et la seule valeur prise en charge est Version4 (Version3 et Version2 requièrent une distribution de dossier public).

VirtualDirectories

Facultatif

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre VirtualDirectories spécifie les répertoires virtuels de 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 le répertoire virtuel de façon unique. Par exemple :

  • Nom ou <Server>\Name

  • Nom unique (DN)

  • GUID

La valeur Name utilise la syntaxe « <VirtualDirectoryName> (<WebsiteName>) » à partir des propriétés du répertoire virtuel. Vous pouvez insérer le caractère générique (*) à la place du site web par défaut en utilisant la syntaxe <VirtualDirectoryName>*.

La valeur par défaut de ce paramètre correspond aux services d’accès aux clients (frontaux) et aux répertoires virtuels de carnet d’adresses en mode hors connexion (principaux) sur le serveur de boîte aux lettres qui contient la boîte aux lettres de génération du carnet d’adresses en mode hors connexion (paramètreGeneratingMailbox ou SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}) lors de sa création (par exemple, Mailbox01\OAB (Default Web Site),Mailbox01\OAB (Exchange Back End).

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 ce paramètre sur $null, puis de définir le paramètre GlobalWebDistributionEnabled sur $true, car les services d’accès aux clients sur les serveurs 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.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: