Get-MailboxFolder

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-MailboxFolder permet d’afficher les dossiers de votre propre boîte aux lettres. Les administrateurs ne peuvent pas utiliser cette cmdlet pour afficher des dossiers d’autres boîtes aux lettres (la cmdlet est uniquement disponible avec le rôle utilisateur MyBaseOptions).

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] <COMMON PARAMETERS>
Get-MailboxFolder -GetChildren <SwitchParameter> [-Identity <MailboxFolderIdParameter>] [-MailFolderOnly <SwitchParameter>] [-ResultSize <Unlimited>] <COMMON PARAMETERS>
Get-MailboxFolder -Recurse <SwitchParameter> [-Identity <MailboxFolderIdParameter>] [-MailFolderOnly <SwitchParameter>] [-ResultSize <Unlimited>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-DomainController <Fqdn>]

Cet exemple récupère le dossier Boîte de réception dans la boîte aux lettres de Jean-Charles. Le paramètre Identity est fourni au format <Identité de la boîte aux lettres>:<Dossier>.

Get-MailboxFolder -Identity Tony:\Inbox

Cet exemple renvoie les dossiers racines dans la boîte aux lettres de Jean-Charles. Le paramètre Identity est fourni au format <Identité de la boîte aux lettres>.

Get-MailboxFolder -Identity Tony

Cet exemple renvoie le premier niveau de dossiers de messagerie dans la boîte aux lettres de Jean-Charles.

Get-MailboxFolder -Identity Tony -GetChildren -MailFolderOnly

Cet exemple renvoie des informations sur tous les sous-dossiers qui se trouvent sous Boîte de réception, dans la boîte aux lettres de Jean-Charles.

Get-MailboxFolder -Identity Tony:\Inbox -GetChildren

Cet exemple renvoie tous les niveaux des dossiers se trouvant sous Boîte de réception, dans la boîte aux lettres de Jean-Charles.

Get-MailboxFolder -Identity Tony:\Inbox -Recurse

Si la boîte aux lettres n'est pas spécifiée, la cmdlet renvoie les dossiers spécifiés dans la boîte aux lettres du propriétaire de boîte aux lettres qui exécute la commande. Avant de récupérer les dossiers demandés, cette commande vérifie que la boîte aux lettres spécifiée dans le paramètre Identity est une boîte aux lettres Exchange valide. La cmdlet renvoie tous les dossiers si le commutateur MailFolderOnly n’est pas défini.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Paramètre Obligatoire Type Description

GetChildren

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre GetChildren indique si seul le premier niveau de sous-dossiers du dossier parent spécifié doit être renvoyé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous devez utiliser ce commutateur avec le commutateur Recurse.

Recurse

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur Recurse indique si le dossier parent spécifié et tous ses sous-dossiers doivent être renvoyés. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous devez utiliser ce commutateur avec le commutateur GetChildren.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Le paramètre Identity permet de définir la boîte aux lettres et le dossier à afficher. Si vous n’indiquez pas le dossier, la commande renvoie des informations sur les dossiers de la hiérarchie racine de la boîte aux lettres spécifiée. Pour définir des valeurs pour ce paramètre, vous devez utiliser la syntaxe suivante : <Identité de la boîte aux lettres>:<Parent>.

Les valeurs valides pour <Mailbox Identity> sont les identificateurs uniques de la boîte aux lettres.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Les valeurs de <Parent> peuvent être l'identificateur d'un objet banque d'informations et une chaîne de chemin d'accès comme \Boîte de réception\Personnel.

MailFolderOnly

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre MailFolderOnly indique si seuls les dossiers de messagerie de la boîte aux lettres spécifiée doivent être renvoyés. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

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

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: