Condividi tramite

Get-PublicFolder (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-06

Utilizzare il cmdlet Get-PublicFolder per recuperare gli attributi di una cartella pubblica oppure di un insieme di cartelle pubbliche.

Sintassi

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

Descrizione dettagliata

Per eseguire il cmdlet Get-PublicFolder, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange View-Only Administrator

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

GetChildren

Obbligatorio

System.Management.Automation.SwitchParameter

Utilizzare il parametro GetChildren per recuperare solo gli oggetti secondari della cartella specificata dal parametro Identity. Il parametro GetChildren e il parametro Recurse si escludono a vicenda.

Recurse

Obbligatorio

System.Management.Automation.SwitchParameter

Utilizzare il parametro Recurse per restituire la cartella pubblica specificata e tutti i relativi oggetti secondari quando viene eseguito il comando.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che consente di recuperare i dati dal servizio directory di Active Directory, includere nel comando il parametro DomainController.

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

Il parametro Identity consente di specificare il GUID o il nome che rappresenta una specifica cartella pubblica. È possibile includere anche il percorso utilizzando il formato TopLevelPublicFolder\PublicFolder.

È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il GUID o il nome della cartella pubblica.

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Il valore massimo predefinito è 10.000. Per non impostare alcun limite al numero di risultati restituiti, impostare il parametro su Unlimited. È possibile trasmettere il parametro solo in combinazione con il parametro Recurse o il parametro GetChildren.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Il parametro Server consente di specificare il server sul quale eseguire le operazioni selezionate.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Nel seguente codice di esempio viene mostrato come utilizzare il comando Get-PublicFolder:

  • Nel primo esempio il comando Get-PublicFolder viene utilizzato senza parametri in modo da restituire l'oggetto della cartella pubblica radice (IPM_SUBTREE).

  • Nel secondo esempio vengono restituiti i nomi di tutte le cartelle di sistema (che non vengono visualizzate per impostazione predefinita), a partire dalla directory radice delle cartelle di sistema (\NON_IPM_SUBTREE).

  • Nel terzo esempio viene restituita la cartella pubblica con l'identificatore a lungo termine della voce specificato.

  • Nel quarto esempio viene restituita la cartella pubblica Pending Litigation di \Legal\Documents\.

  • Nel quinto esempio vengono restituite la cartella pubblica Pending Litigation di \Legal\Documents\ e fino a 9.999 sottocartelle pubbliche della cartella pubblica Pending Litigation.

  • Nel sesto esempio vengono restituite la cartella pubblica Pending Litigation di \Legal\Documents\ e tutte le relative sottocartelle pubbliche, senza alcun limite.

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