Get-Mailbox

  • Article

 

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

Dernière rubrique modifiée : 2010-04-27

La cmdlet Get-Mailbox permet d'afficher les objets et attributs de boîte aux lettres, de remplir des pages de propriétés ou de fournir des informations de boîte aux lettres à d'autres tâches.

Syntaxe

get-Mailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Description détaillée

La cmdlet Get-Mailbox extrait les attributs et les objets d'une boîte aux lettres. Aucun paramètre n'est obligatoire. Si la cmdlet est utilisée sans paramètre, toutes les boîtes aux lettres de l'organisation sont répertoriées.

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

  • le rôle Administrateur Affichage seul d'Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Notes

Pour évaluer avec précision l'état actuel du quota de stockage à l'aide de la cmdlet Get-Mailbox, il est nécessaire de consulter la propriété UseDatabaseQuotaDefaults en plus des propriétés ProhibitSendQuota, ProhibitSendReceiveQuota et IssueWarningQuota. Lorsque la valeur de la propriété UseDatabaseQuotaDefaults est True, les paramètres des boîtes aux lettres individuelles sont ignorés et les limites de base de données de boîtes aux lettres sont utilisées. Si cette propriété est définie sur True et les propriétés ProhibitSendQuota, ProhibitSendReceiveQuota et IssueWarningQuota sont définies sur « illimité », la taille de la boîte aux lettres n’est pas illimitée. Vous devez consulter les limites de stockage de la base de données de boîtes aux lettres pour connaître les limites de la boîte aux lettres. Lorsque la valeur de la propriété UseDatabaseQuotaDefaults est False, les paramètres des boîtes aux lettres individuelles sont utilisés.

Paramètres

Paramètre Obligatoire Type Description

Anr

Facultatif

System.String

Le paramètre Anr spécifie une chaîne sur laquelle effectuer une recherche de la fonction Résolution de nom ambigu (ANR). Vous pouvez spécifier une chaîne partielle et rechercher des objets ayant un attribut correspondant à cette chaîne. Les attributs par défaut recherchés sont :

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Facultatif

System.Management.Automation.PSCredential

Le paramètre Credential spécifie le nom et le mot de passe d'utilisateur à utiliser pour accéder au service d'annuaire Active Directory.

Database

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre Database spécifie la base de données à partir de laquelle extraire la boîte aux lettres. Vous pouvez utiliser les valeurs suivantes :

  • GUID de la base de données

  • 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 ne peut pas être utilisé avec le paramètre Filter.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour accéder à Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

Filter

Facultatif

System.String

Le paramètre Filter spécifie un ou plusieurs attributs utilisés pour limiter le nombre de boîtes aux lettres renvoyées par la requête.

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

Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -Filter.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity identifie la boîte aux lettres. Vous pouvez utiliser l'une des valeurs suivantes :

  • GUID

  • Nom unique

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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 utilisera 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.

  • Vous ne pouvez pas utiliser les paramètres OrganizationalUnit et Identity ensemble.

  • Vous ne pouvez pas utiliser le paramètre Credential.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Le paramètre OrganizationalUnit spécifie une unité d'organisation (UO) et est utilisé pour limiter les résultats. Si vous utilisez ce paramètre, vous n'obtenez que des boîtes aux lettres dans le conteneur que vous spécifiez. Vous pouvez utiliser soit l'UO, soit le nom de domaine. Si vous utilisez l'UO, vous devez spécifier son nom canonique.

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ReadFromDomainController spécifie que les informations utilisateur sont lues à partir d'un contrôleur de domaine dans le domaine de l'utilisateur. Si vous définissez la portée du destinataire pour inclure tous les destinataires de la forêt et si vous n'utilisez pas ce paramètre, il est possible que les informations utilisateur soient lues à partir d'un catalogue global avec des informations obsolètes. Si vous utilisez ce paramètre, plusieurs lectures peuvent être nécessaires pour obtenir les informations.

> [!Note] > Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

RecipientTypeDetails

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Le paramètre RecipientTypeDetails spécifie le type des destinataires renvoyés. Les types de destinataires dans Microsoft Exchange Server 2007 sont divisés en types et sous-types de destinataires. Chaque type de destinataire contient toutes les propriétés de tous les sous-types. Par exemple, le type UserMailbox représente un compte d'utilisateur dans Active Directory avec une boîte aux lettres associée. Comme il y a plusieurs types de boîtes aux lettres, chaque type est identifié par le paramètre RecipientTypeDetails. Par exemple, le paramètre RecipientTypeDetails d'une boîte aux lettres de salle de conférence est défini sur RoomMailbox, tandis que le paramètre RecipientTypeDetails d'une boîte aux lettres d'utilisateur est défini sur UserMailbox.

Pour cette commande, les détails de type de destinataire disponible sont les suivants :

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à retourner. Pour retourner toutes les boîtes aux lettres correspondant à la requête, utilisez « unlimited » comme valeur pour ce paramètre. La valeur par défaut est 1000.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie un serveur individuel et est utilisé pour limiter les résultats. Si vous utilisez ce paramètre, vous n'obtenez que des boîtes aux lettres résidant sur le serveur que vous spécifiez. Utilisez le nom commun du serveur que vous voulez spécifier.

SortBy

Facultatif

System.String

Le paramètre SortBy spécifie l'attribut utilisé pour trier les résultats. Vous ne pouvez trier que sur un attribut à la fois. Vous pouvez trier sur les attributs suivants :

  • Alias

  • Nom complet

  • Name

Les résultats sont triés en ordre croissant.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

Le premier exemple montre comment obtenir la liste de toutes les boîtes aux lettres au sein de votre organisation.

Le deuxième exemple montre comment obtenir la liste de toutes les boîtes aux lettres au sein de votre organisation dans le conteneur Utilisateurs du domaine Contoso.com.

Le troisième exemple montre comment obtenir toutes les boîtes aux lettres résolues via la recherche de la fonction Résolution de nom ambigu sur la chaîne « Chr » du domaine de DC01. Cela renvoie les boîtes aux lettres des utilisateurs tels que Chris Ashton, Christian Cletus et Christa Geller.

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01