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-PublicFolderCet 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 NameCet 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" -RecurseCet 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 UnlimitedCet 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" -ResidentFoldersCet 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.