Partager via


Get-PublicFolder

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

La cmdlet Get-PublicFolder permet d'extraire les attributs d'un dossier public ou d'un ensemble de dossiers publics.

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

Syntax

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [-LostAndFound]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Description

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 requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Get-PublicFolder

Cet exemple utilise la commande Get-PublicFolder sans paramètre pour renvoyer l'objet dossier public racine (IPM_SUBTREE).

Exemple 2

Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name

Cet exemple renvoie les noms de tous les dossiers système (qui ne sont pas affichés par défaut), à partir de la racine des dossiers système (\NON_IPM_SUBTREE).

Exemple 3

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"

Cet exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\.

Exemple 4

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse

Cet exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\ ainsi que tous les dossiers publics qu'il contient. La taille du résultat n'étant pas spécifiée, la commande retourne le nombre maximal de dossiers publics, soit 10 000.

Exemple 5

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

Cet exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\ ainsi que tous les dossiers publics qu'il contient, sans limite quant au nombre renvoyé.

Exemple 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

Cet exemple renvoie les dossiers publics présents dans la boîte aux lettres de contenu de dossiers publics Legal Department.

Paramètres

-DomainController

Ce paramètre est disponible uniquement dans Exchange 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 ».

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetChildren

Le commutateur GetChildren spécifie s’il faut renvoyer uniquement les enfants du dossier spécifié par le paramètre Identity. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous ne pouvez pas utiliser ce commutateur avec les commutateurs Recurse ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Le paramètre Identity spécifie le nom et le chemin du dossier public que vous souhaitez afficher. Une valeur valide utilise la syntaxe : \Level1\Level2\...\LevenN\PublicFolder. Par exemple : "\Customer Discussion" ou "\Engineering\Customer Discussion".

Type:PublicFolderIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LostAndFound

Le commutateur LostAndFound spécifie s’il faut retourner uniquement les dossiers orphelins situés dans \NON_IPM_SUBTREE\LOST_AND_FOUND. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le dossier LOST_AND_FOUND contient les dossiers manquants qui sont recréés par le processus de rapprochement de la hiérarchie des dossiers publics lorsque le dossier existe dans une boîte aux lettres de dossier public secondaire, mais pas dans le dossier principal.

Vous ne pouvez pas utiliser ce commutateur avec le paramètre Identity ou les commutateurs Recurse ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

Le paramètre Mailbox spécifie l’identité de la boîte aux lettres de dossiers publics des hiérarchies. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse e-mail
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Organization

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

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:OrganizationIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Recurse

Le commutateur Recurse spécifie s’il faut retourner le dossier public spécifié et tous ses enfants. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous ne pouvez pas utiliser ce commutateur avec les commutateurs GetChildren ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResidentFolders

Le commutateur ResidentFolders spécifie s’il faut retourner les dossiers publics qui résident dans une boîte aux lettres de dossier public de contenu spécifique. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, la commande retourne uniquement les dossiers publics dont le contenu réside dans la boîte aux lettres des dossiers publics de la hiérarchie principale.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. La valeur maximale par défaut est 10 000. Pour lever toute limite aux résultats renvoyés, définissez ce paramètre sur Unlimited. Ce paramètre ne peut être transmis qu'en association avec les paramètres Recurse ou GetChildren.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Server

Ce paramètre n'est disponible que dans Exchange Server 2010.

Le paramètre Server filtre les résultats en fonction du serveur Exchange spécifié. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • FQDN
  • Nom unique
  • DN Exchange hérité
Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

Entrées

Input types

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.

Sorties

Output types

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.