Remove-Mailbox (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
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> [-DomainController <Fqdn>] [-Permanent <$true | $false>]
Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-DomainController <Fqdn>]
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 |
---|---|---|---|
Base de données |
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 :
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 :
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. |
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. |
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. |
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