Connect-Mailbox

La cmdlet est disponible uniquement dans Exchange en local.

Utilisez l’applet de commande Connect-Mailbox pour connecter des boîtes aux lettres déconnectées à des comptes d’utilisateur existants qui n’ont pas encore de boîtes aux lettres.

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

Syntax

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Equipment]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       -LinkedDomainController <Fqdn>
       -LinkedMasterAccount <UserIdParameter>
       [-LinkedCredential <PSCredential>]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Room]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Shared]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-ValidateOnly]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-User <UserIdParameter>]
       [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
       [-AllowLegacyDNMismatch]
       [-Archive]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

Description

Si vous liez une boîte aux lettres à un compte d’utilisateur existant, ce compte d’utilisateur bénéficie d’un accès total à la boîte aux lettres et à l’intégralité de son contenu.

Si vous utilisez le paramètre User pour spécifier le compte d’utilisateur, veillez à spécifier le compte approprié. Si vous n’utilisez pas le paramètre User, il est recommandé d’utiliser le commutateur ValidateOnly pour vérifier le compte d’utilisateur auquel la boîte aux lettres tentera de se connecter.

Il n’existe pas de cmdlet Disconnect-Mailbox. Vous pouvez utiliser les cmdlets Disable-Mailbox ou Remove-Mailbox pour déconnecter efficacement des boîtes aux lettres des comptes d’utilisateurs.

Utilisez la cmdlet Disable-Mailbox pour effectuer les actions suivantes :

  • Déconnecter la boîte aux lettres du compte d’utilisateur.
  • Conserver la boîte aux lettres dans un état désactivé avant sa suppression définitive, soumise à la période de rétention de boîte aux lettres supprimée.
  • Conservez le compte d’utilisateur, mais supprimez les attributs Exchange du compte.

Utilisez la cmdlet Remove-Mailbox pour effectuer les actions suivantes :

  • Déconnecter la boîte aux lettres du compte d’utilisateur.
  • Conserver la boîte aux lettres dans un état désactivé avant sa suppression définitive, soumise à la période de rétention de boîte aux lettres supprimée (sauf si vous utilisez les paramètres Permanent ou StoreMailboxIdentity, qui supprimeront immédiatement la boîte aux lettres de la base de données).
  • Supprimer le compte d’utilisateur.

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

Connect-Mailbox -Database "Mailbox Database" -Identity "John Evans"

Cet exemple connecte la boîte aux lettres déconnectée de John Evans. L’exemple ne spécifie pas un utilisateur à connecter à la boîte aux lettres, la commande tente de trouver un objet utilisateur correspondant, de manière unique.

Exemple 2

Connect-Mailbox -Identity "John Evans" -Database "MBXDB02" -LinkedDomainController FabrikamDC01 -LinkedMasterAccount john@fabrikam.com

Cet exemple montre comment connecter une boîte aux lettres liée.

Exemple 3

Connect-Mailbox -Identity "CAR001" -Database "MBXResourceDB" -Equipment -User "CAR001"

Cet exemple montre comment connecter une boîte aux lettres de ressource.

Exemple 4

Connect-Mailbox -Identity "ConfRm212" -Database "MBXResourceDB" -Room -User "Conference Room 212"

Cet exemple montre comment connecter une boîte aux lettres de salle.

Paramètres

-ActiveSyncMailboxPolicy

Le paramètre ActiveSyncMailboxPolicy spécifie la stratégie de boîte aux lettres d’appareil mobile qui est appliquée à la boîte aux lettres. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Si vous ne spécifiez pas ce paramètre, la stratégie de boîte aux lettres d’appareil mobile par défaut est utilisée.

Type:MailboxPolicyIdParameter
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

-AddressBookPolicy

Le paramètre AddressBookPolicy spécifie la stratégie de carnet d’adresses qui s’applique à cette boîte aux lettres. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie de carnet d’adresses. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Pour plus d’informations sur les stratégies de carnet d’adresses, consultez Stratégies de carnet d’adresses dans Exchange Server.

Type:AddressBookMailboxPolicyIdParameter
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

-Alias

Le paramètre Alias spécifie l’alias Exchange (également appelé surnom de messagerie) pour le destinataire. Cette valeur identifie le destinataire en tant qu’objet à extension messagerie et ne doit pas être confondue avec plusieurs adresses e-mail pour le même destinataire (également appelées adresses proxy). Un destinataire ne peut avoir qu’une seule valeur Alias. La longueur maximale est de 64 caractères.

La valeur Alias peut contenir des lettres, des chiffres et les caractères suivants :

  • !, #, %, *, +, -, /, =, ?, ^, _, et ~.
  • $, &, ', ', {, }et | doivent être placés dans une séquence d’échappement (par exemple -Alias what`'snew) ou la valeur entière placée entre guillemets simples (par exemple, -Alias 'what'snew'). Le & caractère n’est pas pris en charge dans la valeur Alias pour la synchronisation Azure AD Connect.
  • Les points (.) doivent être entourés d’autres caractères valides (par exemple, help.desk).
  • Caractères Unicode U+00A1 à U+00FF.

Lorsque vous créez un destinataire sans spécifier d’adresse e-mail, la valeur Alias que vous spécifiez est utilisée pour générer l’adresse e-mail principale (alias@domain). Les caractères Unicode pris en charge sont mappés avec les caractères de texte US-ASCII les plus adaptés. Par exemple, U+00F6 (ö) est remplacé par oe dans l’adresse e-mail principale.

Si vous n’utilisez pas le paramètre Alias lorsque vous créez un destinataire, la valeur d’un autre paramètre requis est utilisée pour la valeur de la propriété Alias :

  • Destinataires avec des comptes d’utilisateur (par exemple, des boîtes aux lettres utilisateur et des utilisateurs de messagerie) : le côté gauche du paramètre MicrosoftOnlineServicesID ou UserPrincipalName est utilisé. Par exemple, helpdesk@contoso.onmicrosoft.com génère la valeur helpdeskde la propriété Alias .
  • Destinataires sans compte d’utilisateur (par exemple, boîtes aux lettres de salle, contacts de messagerie et groupes de distribution) : la valeur du paramètre Name est utilisée. Les espaces sont supprimés et les caractères non pris en charge sont convertis en points d’interrogation (?).

Si vous modifiez la valeur Alias d’un destinataire existant, l’adresse e-mail principale est automatiquement mise à jour uniquement dans les environnements où le destinataire est soumis à des stratégies d’adresse de messagerie (la propriété EmailAddressPolicyEnabled a la valeur True pour le destinataire).

Le paramètre Alias ne génère ni ne met à jour l’adresse e-mail principale d’un contact de messagerie ou d’un utilisateur de messagerie.

Type:String
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

-AllowLegacyDNMismatch

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

Type:SwitchParameter
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

-Archive

Le commutateur Archive spécifie si une connexion à la boîte aux lettres d’archivage associée doit être établie. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
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

-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

-Database

Le paramètre Database spécifie la base de données Exchange qui contient la boîte aux lettres que vous souhaitez connecter. 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 spécifier la boîte aux lettres à connecter, vous utilisez ce paramètre avec le paramètre Identity.

Type:DatabaseIdParameter
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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

-Equipment

Le commutateur Équipement est nécessaire pour connecter des boîtes aux lettres d’équipement. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Les boîtes aux lettres d’équipement sont des boîtes aux lettres de ressources qui ne sont pas associées à un emplacement spécifique (par exemple, des véhicules ou des ordinateurs).

Type:SwitchParameter
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

-Force

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.

Type:SwitchParameter
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

-Identity

Le paramètre Identity spécifie la boîte aux lettres à laquelle vous voulez connecter un compte d’utilisateur. Ce paramètre ne spécifie pas d’objet Active Directory. Vous pouvez utiliser les valeurs suivantes pour identifier la boîte aux lettres :

  • Nom complet
  • GUID
  • LegacyExchangeDN

Pour spécifier la boîte aux lettres à connecter, vous utilisez ce paramètre avec le paramètre Database.

Type:StoreMailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedCredential

Le paramètre LinkedCredential spécifie les informations d’identification utilisés pour accéder au contrôleur de domaine spécifié par le paramètre LinkedDomainController. Ce paramètre est facultatif, même si vous connectez une boîte aux lettres liée.

Une valeur pour ce paramètre nécessite l’applet de commande Get-Credential. Pour interrompre la commande et recevoir une invite à entrer les informations d’identification, utilisez la valeur (Get-Credential). Sinon, avant d’exécuter cette commande, stockez les informations d’identification dans une variable (par exemple, $cred = Get-Credential), puis utilisez le nom de cette variable name ($cred) pour ce paramètre. Pour plus d’informations, voir Get-Credential.

Type:PSCredential
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

-LinkedDomainController

Le paramètre LinkedDomainController spécifie le contrôleur de domaine dans la forêt où réside le compte d’utilisateur, si cette boîte aux lettres est liée. Le contrôleur de domaine dans la forêt où réside le compte d’utilisateur est utilisé pour obtenir des informations de sécurité pour le compte spécifié par le paramètre LinkedMasterAccount. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser comme valeur pour ce paramètre.

Ce paramètre est requis uniquement si vous vous connectez à une boîte aux lettres liée.

Type:Fqdn
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

-LinkedMasterAccount

Le paramètre LinkedMasterAccount spécifie le compte principal dans la forêt où réside le compte d’utilisateur, si cette boîte aux lettres est liée. Le compte principal est le compte auquel la boîte aux lettres est liée. Le compte principal accorde l’accès à la boîte aux lettres. Ce paramètre est nécessaire uniquement si vous créez une boîte aux lettres liée. Vous pouvez utiliser n’importe quelle valeur qui identifie le compte principal de manière unique. Par exemple : Par exemple :

  • Nom
  • Nom unique
  • Nom unique
  • GUID

Ce paramètre est requis uniquement si vous vous connectez à une boîte aux lettres liée.

Type:UserIdParameter
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

-ManagedFolderMailboxPolicy

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

Type:MailboxPolicyIdParameter
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

-ManagedFolderMailboxPolicyAllowed

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

Type:SwitchParameter
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

-RetentionPolicy

Le paramètre RetentionPolicy spécifie la stratégie de rétention qui est appliquée à la boîte aux lettres. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Les stratégies de rétention consistent en des balises qui sont appliquées aux dossiers de boîte aux lettres et aux éléments de courrier pour déterminer la durée de rétention des éléments.

Type:MailboxPolicyIdParameter
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

-Room

Le commutateur Salle est nécessaire pour connecter les boîtes aux lettres de salle. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Les boîtes aux lettres de salle sont des boîtes aux lettres de ressources associées à un emplacement spécifique (par exemple, les salles de conférence).

Type:SwitchParameter
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

-Shared

Le commutateur Partagé est requis pour connecter des boîtes aux lettres partagées. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Une boîte aux lettres partagée est une boîte aux lettres à laquelle plusieurs utilisateurs peuvent se connecter pour accéder au contenu de la boîte aux lettres. Cette boîte aux lettres n’est associée à aucun des utilisateurs pouvant se connecter. Elle est associée à un compte d'utilisateur désactivé.

Type:SwitchParameter
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

-User

Le paramètre User spécifie l’objet utilisateur dans Active Directory auquel vous souhaitez connecter la boîte aux lettres. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de façon unique. Par exemple : Par exemple :

  • Nom
  • Nom unique
  • Nom unique
  • GUID

Si vous n’utilisez pas ce paramètre, la commande utilise les valeurs de propriété LegacyExchangeDN et DisplayName de la boîte aux lettres pour rechercher un compte d’utilisateur qui a les mêmes valeurs. Si elle ne trouve pas de correspondance unique, elle ne connecte pas la boîte aux lettres.

Type:UserIdParameter
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

-ValidateOnly

Le commutateur ValidateOnly indique à la cmdlet d’évaluer les conditions et exigences nécessaires pour effectuer l’opération et signale ensuite si l’opération réussit ou échoue. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Aucune modification n’est apportée lorsque vous utilisez ce commutateur.

Type:SwitchParameter
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

-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

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.