Partager via

Get-PublicFolder (RTM)

  • Article

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-06-06

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

Syntaxe

Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Description détaillée

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

  • le rôle Administrateur Affichage seul d'Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

GetChildren

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre GetChildren permet de n'extraire que les enfants du dossier spécifié par le paramètre Identity. Le paramètre GetChildren est incompatible avec le paramètre Recurse.

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

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

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 le paramètre Recurse ou GetChildren.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le serveur sur lequel exécuter les opérations sélectionnées.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

L'exemple de code suivant présente l'utilisation de la commande Get-PublicFolder :

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

  • Le deuxième 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).

  • Le troisième exemple renvoie le dossier public avec l'identificateur d'entrée à long terme spécifié.

  • Le quatrième exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\.

  • Le cinquième exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\ et jusqu'à 9 999 dossiers publics sous le dossier public Pending Litigation.

  • Le sixième exemple renvoie le dossier public Pending Litigation à partir de \Legal\Documents\ et tous les sous-dossiers publics, sans limite quant au nombre renvoyé.

Get-PublicFolder 
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name  
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited