Remove-Mailbox

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet Remove-Mailbox permet de supprimer le compte d'utilisateur associé à une boîte aux lettres spécifique du service d'annuaire Active Directory et de traiter la boîte aux lettres déconnectée associée selon les paramètres spécifiés.

Syntaxe

Remove-Mailbox -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Permanent <$true | $false>] [-WhatIf [<SwitchParameter>]]

Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Remove-Mailbox supprime du compte d'utilisateur Active Directory associé à une boîte aux lettres spécifique, puis gère le traitement de la boîte aux lettres déconnectée associée à l'aide des paramètres spécifiés.

L'utilisation du paramètre Identity seul permet de déconnecter la boîte aux lettres de l'utilisateur et de supprimer l'objet utilisateur d'Active Directory. L'objet boîte aux lettres existe toujours. Par défaut, cette boîte aux lettres est conservée pendant 30 jours dans la base de données Exchange, puis elle est supprimée.

Les paramètres Identity et Permanent permettent de déconnecter la boîte aux lettres de l'utilisateur, de supprimer l'objet utilisateur d'Active Directory et de supprimer l'objet boîte aux lettres de la base de données Exchange. L'objet boîte aux lettres n'est pas conservé dans la base de données Exchange en tant que boîte aux lettres déconnectée.

Les paramètres Database et StoreMailboxIdentity permettent de supprimer l'objet boîte aux lettres de la base de données Exchange. Dans ce cas, l'objet boîte aux lettres a déjà été déconnecté de l'utilisateur. Par exemple, si vous exécutez la cmdlet Disable-Mailbox, l'objet boîte aux lettres Exchange continue à exister mais est déconnecté de l'objet utilisateur Active Directory. Les paramètres Database et StoreMailboxIdentity permettent de supprimer cet objet boîte aux lettres déconnectée.

Pour exécuter la cmdlet Remove-Mailbox, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

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

Database

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre Database spécifie la base de données qui contient l'objet boîte aux lettres. Vous pouvez utiliser l'une des valeurs suivantes :

  • GUID

  • Nom de la base de données

  • Nom de serveur\nom de base de données

  • Nom de serveur\groupe de stockage\nom de base de données

Si vous ne spécifiez pas le nom de serveur, la cmdlet recherche la base de données sur le serveur local. Si vous avez plusieurs bases de données portant le même nom sur le même serveur, vous devez spécifier le groupe de stockage.

Ce paramètre doit être utilisé avec le paramètre StoreMailboxIdentity. Le paramètre Database ne peut pas être utilisé avec le paramètre Identity. Si vous avez déconnecté une boîte aux lettres de son utilisateur associé et que vous voulez supprimer l'objet boîte aux lettres de la banque d’informations Exchange, utilisez les paramètres Database et StoreMailboxIdentity.

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity identifie l'objet boîte aux lettres que vous voulez supprimer. Vous pouvez utiliser l'une des valeurs suivantes :

  • ADObjectID

  • Nom unique

  • DN hérité, GUID

  • Domaine\Nom de compte

  • Nom d'utilisateur principal (UPN)

  • Adresse de messagerie

  • Alias

Le paramètre Identity ne peut pas être utilisé avec le paramètre Database.

StoreMailboxIdentity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

Le paramètre StoreMailboxIdentity identifie l'objet boîte aux lettres à supprimer. Le paramètre StoreMailboxIdentity est utilisé en association avec le paramètre Database pour supprimer l'objet boîte aux lettres de la base de données Exchange. Si vous avez déconnecté une boîte aux lettres de son utilisateur associé et que vous voulez supprimer l'objet boîte aux lettres de la banque d’informations Exchange, utilisez les paramètres Database et StoreMailboxIdentity.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine qui écrit ce changement de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utiliser automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

Permanent

Facultatif

System.Boolean

Lorsqu'il est utilisé en association avec le paramètre Identity, le paramètre Permanent déconnecte la boîte aux lettres de l'utilisateur, supprime l'objet utilisateur associé d'Active Directory et supprime l'objet boîte aux lettres de la base de données Exchange. Les valeurs possibles pour ce paramètre sont $true ou $false. La valeur par défaut est $false.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

Le premier exemple décrit la procédure de déconnexion de la boîte aux lettres de l'utilisateur John Peoples (john) à partir du compte d'utilisateur et de suppression de l'objet boîte aux lettres d'Active Directory. La boîte aux lettres restera dans la base de données Exchange pendant la période de rétention des boîtes aux lettres supprimées configurée pour la base de données de boîtes aux lettres.

Le deuxième exemple décrit la procédure de déconnexion de la boîte aux lettres de l'utilisateur John Peoples (john) du compte d'utilisateur, de suppression de l'objet boîte aux lettres d'Active Directory et de suppression de la boîte aux lettres de la base de données Exchange.

Le troisième exemple décrit la procédure de suppression de la boîte aux lettres de John Peoples (john) de la base de données Exchange, en partant de l'hypothèse que la boîte aux lettres a déjà été déconnectée de l'utilisateur. L'exemple montre comment utiliser la cmdlet Get-MailboxStatistics pour extraire la valeur de GUID de boîte aux lettres en utilisant le nom complet de la boîte aux lettres déconnectée. Cette valeur est nécessaire pour le paramètre StoreMailboxIdentity de la cmdlet Remove-Mailbox.

Remove-Mailbox -Identity contoso\john
Remove-Mailbox -Identity contoso\john -Permanent $true
$Temp = Get-MailboxStatistics | Where {$_.DisplayName -eq 'John Peoples'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid