Get-UMMailbox

  • Article

 

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

Dernière rubrique modifiée : 2007-07-20

La cmdlet Get-UMMailbox affiche les propriétés de messagerie unifiée (MU) d'un destinataire à MU activée.

Syntaxe

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

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

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

Description détaillée

La cmdlet Get-UMMailbox extrait les propriétés de MU pour une boîte aux lettres de MU unique. Elle peut également retourner la liste des boîtes aux lettres à MU activée.

Pour exécuter la cmdlet Get-UMMailbox , vous devez utiliser un compte auquel le rôle Administrateur des destinataires 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 Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Anr

Facultatif

System.String

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

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

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory.

Filter

Facultatif

System.String

Ce paramètre vous permet de filtrer les résultats retournés par la cmdlet.

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 spécifie l'utilisateur à activer pour la messagerie unifiée. Les variables pour ce paramètre sont les suivantes :

  • ADObjectID

  • GUID

  • DN

  • Domaine\Compte

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Ce paramètre est obligatoire si le paramètre Instance n'est pas utilisé.

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 spécifie une unité d'organisation (UO) et est utilisé pour limiter les résultats. Si vous utilisez ce paramètre, vous n'extrayez que des boîtes aux lettres dans le conteneur que vous spécifiez. Vous pouvez utiliser l'UO ou le nom de domaine. Si vous utilisez l'UO, vous devez spécifier son nom canonique.

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 catalogue global dont les informations dont obsolètes. Si vous utilisez ce paramètre, plusieurs lectures peuvent être nécessaires pour obtenir les informations. 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 vous permet de spécifier le nombre maximal de résultats à retourner. Sinon, aucun nombre maximal n'étant spécifié, la cmdlet renvoie tous les résultats.

SortBy

Facultatif

System.String

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

  • DisplayName

  • Name

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

Types d'entrées

Type Description

 

 

Types de retours

Type Description

 

 

Erreurs

Erreur Description

 

 

Exemple

Le premier exemple de code affiche la liste de toutes les boîtes aux lettres à extension messagerie unifiée dans la forêt Active Directory sous la forme d'une liste mise en forme.

Le second exemple de code affiche les propriétés de boîte aux lettres de messagerie unifiée pour yanli@contoso.com.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com