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
helpdesk
de 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.