Partager via


Get-CASMailbox

 

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

Dernière rubrique modifiée : 2011-01-21

La cmdlet Get-CASMailbox retourne la liste des attributs d'une boîte aux lettres Microsoft Exchange Server 2007 sur un ordinateur sur lequel le rôle serveur d'accès au client est installé.

Syntaxe

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

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

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

Paramètres

Paramètre Obligatoire Type Description

Anr

Facultatif

System.String

Ce paramètre accepte un jeu de caractères pour effectuer une recherche de résolution des noms ambigus. Les attributs recherchés sont les suivants :

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Facultatif

System.Management.Automation.PSCredential

Ce paramètre spécifie le compte utilisé pour lire le service d'annuaire Active Directory.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le contrôleur de domaine auquel se connecter pour la validation Active Directory.

Filter

Facultatif

System.String

Ce paramètre spécifie un ensemble d'attributs utilisés pour créer une requête destinée à extraire un ensemble de boîtes aux lettres. 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

Ce paramètre peut être l'ADObjectID ou une chaîne représentant le GUID, un nom unique, un domaine/compte, un nom d'utilisateur principal, un nom unique Exchange hérité, une adresse SMTP ou un alias.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre 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

Ce paramètre permet de limiter la recherche à un conteneur spécifique.

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre 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 serveur de catalogue global dont les informations dont obsolètes. Si vous utilisez ce paramètre, plusieurs lectures peuvent être extraire pour obtenir les informations.

Remarque  Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre spécifie le nombre maximal de résultats à retourner. La valeur par défaut est 1000.

SortBy

Facultatif

System.String

Ce paramètre spécifie l'attribut utilisé pour trier les résultats. Les résultats sont triés en ordre croissant.

Description détaillée

La cmdlet Get-CASMailbox retourne la liste des attributs d'une boîte aux lettres sur un serveur d'accès au client Exchange 2007. Plusieurs attributs CASMailbox sont renvoyés. Les types d'attributs retournés sont Outlook Web Access, ActiveSync, POP3 et IMAP4.

Par défaut, tous les attributs sont retournés pour toutes les boîtes aux lettres dans l'organisation Exchange. Vous pouvez filtrer ces résultats à l'aide des fonctionnalités d'Exchange Management Shell.

La cmdlet Get-CASMailbox ne peut s'exécuter que sur un ordinateur Exchange 2007 sur lequel le rôle serveur de boîtes aux lettres est installé. Pour exécuter la cmdlet Get-CASMailbox, vous devez utiliser un compte auquel le rôle Administrateur Affichage seul d'Exchange a été délégué.

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

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple suivant retourne tous les détails de boîte aux lettres de serveur d'accès au client pour l'utilisateur Jeff Hay dans le domaine Contoso.

Get-CASMailbox -identity jeffhay@contoso.com