Partager via

Get-MailPublicFolder

  • Article

 

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

Dernière rubrique modifiée : 2009-05-12

La cmdlet Get-MailPublicFolder permet d'extraire des informations de messagerie sur des dossiers publics à extension messagerie. Pour obtenir des informations sur les paramètres de base (sans relation avec la messagerie) de dossiers publics à extension messagerie, utilisez plutôt la cmdlet Get-PublicFolder.

Syntaxe

Get-MailPublicFolder [-Identity <MailPublicFolderIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

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

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

Description détaillée

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

  • le rôle Administrateur de dossiers publics Exchange et le groupe Administrateurs local pour le serveur cible.

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

Le paramètre Anr utilise un ensemble de caractères comme valeurs à l'aide desquelles effectuer une recherche de résolution de nom ambigu (ANR).

Le service d'annuaire Active Directory utilise la valeur spécifiée et recherche en fonction de sa configuration. Les attributs par défaut recherchés sont notamment le nom commun (CN) et l'alias (mailNickname).

Credential

Facultatif

System.Management.Automation.PSCredential

Le paramètre Credential spécifie le compte à utiliser pour lire Active Directory. Cela s'avère particulièrement utile lorsque vous spécifiez le catalogue global.

Le mot de passe doit être demandé de manière sécurisée.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

Filter

Facultatif

System.String

Le paramètre Filter spécifie un ensemble d'attributs utilisés pour créer une requête destinée à extraire un ensemble de boîtes aux lettres.

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

Le paramètre Identity permet de spécifier le GUID ou le nom de dossier public représentant un dossier public spécifique. Vous pouvez également inclure le chemin d'accès en utilisant le format Dossier_public_niveau_supérieur\Dossier_public.

Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de dossier public ou le GUID.

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 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) à laquelle limiter la recherche. L'UO ou le domaine peuvent être spécifiés. Vous devez spécifier le nom canonique de l'UO.

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.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à retourner.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie l'identité du serveur à partir duquel effectuer l'opération. Si vous ne spécifiez aucun serveur, la commande vérifie si le serveur local est un serveur de boîtes aux lettres exécutant Microsoft Exchange 2007 avec une banque de dossiers publics. Si c'est le cas, le dossier public est créé localement. Sinon, la commande recherche le serveur de boîtes aux lettres Exchange 2007 le plus proche (par coût de site) disposant d'une banque de dossiers publics montée.

SortBy

Facultatif

System.String

Le paramètre SortBy spécifie l'attribut utilisé pour trier les résultats. Le tri porte sur un attribut à la fois. Les résultats sont triés en ordre croissant.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

Cet exemple renvoie tous les dossiers publics à extension messagerie. Dans cet exemple, la sortie de la commande Get-MailPublicFolder est canalisée vers la commande Format-List afin que toutes les informations disponibles soient affichées dans le résultat.

Get-MailPublicFolder | Format-List