Get-PublicFolder

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-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-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 SyntaxeSyntaxe de cmdlet Exchange.

Get-PublicFolder [-Identity <PublicFolderIdParameter>] <COMMON PARAMETERS>

Get-PublicFolder -GetChildren <SwitchParameter> [-Identity <PublicFolderIdParameter>] [-ResultSize <Unlimited>] <COMMON PARAMETERS>

Get-PublicFolder -Recurse <SwitchParameter> [-Identity <PublicFolderIdParameter>] [-ResultSize <Unlimited>] <COMMON PARAMETERS>

Get-PublicFolder -LostAndFound <SwitchParameter> [-ResultSize <Unlimited>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>] [-Organization <OrganizationIdParameter>] [-ResidentFolders <SwitchParameter>]

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

Get-PublicFolder

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

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

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

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

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.

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, sans limite quant au nombre renvoyé.

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

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

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir l’entrée « Dossiers publics » dans la rubrique Autorisations de partage et de collaboration.

 

Paramètre Obligatoire Type Description

GetChildren

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre GetChildren spécifie s'il faut n'extraire que les enfants du dossier spécifié par le paramètre Identity. Vous ne pouvez pas utiliser le paramètre GetChildren avec le paramètre Recurse.

LostAndFound

Obligatoire

System.Management.Automation.SwitchParameter

PARAMVALUE : SwitchParameter

Recurse

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre Recurse spécifie que la commande doit renvoyer le dossier public spécifié et tous ses enfants. Vous n'avez pas besoin de spécifier une valeur avec ce paramètre.

Vous ne pouvez pas utiliser le paramètre GetChildren avec le paramètre Recurse.

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

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 \TopLevelPublicFolder\PublicFolder.

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

Mailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Mailbox spécifie l'identité de la boîte aux lettres de dossiers publics de hiérarchie.

Ce paramètre accepte les valeurs suivantes :

  • Alias

    Exemple : JPhillips

  • Canonical DN

    Exemple : Atlanta.Corp.Contoso.Com/Users/JPhilips

  • Display Name

    Exemple : Jeff Philips

  • Distinguished Name (DN)

    Exemple : CN = JPhillips, CN = Users, DC = Atlanta, DC = Corp, DC = contoso, DC = com

  • Domain\Account

    Exemple : Atlanta\JPhillips

  • GUID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2

  • Immutable ID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com

  • Legacy Exchange DN

    Exemple : /o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhilips

  • SMTP Address

    Exemple : Jeff.Phillips@contoso.com

  • User Principal Name

    Exemple : JPhillips@contoso.com

Organization

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

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

ResidentFolders

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ResidentFolders indique s'il faut renvoyer les dossiers publics présents dans une boîte aux lettres de dossiers publics de contenu spécifique. Si ce paramètre n’est pas spécifié, la commande ne renvoie que les dossiers publics dont le contenu se trouve dans la boîte aux lettres de dossiers publics de hiérarchie principale.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à retourner. 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.

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: