Get-PublicFolder
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2009-05-12
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>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <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 amministratore cartelle pubbliche di Exchange e gruppo Administrators locale del server di destinazione.
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) 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 della cartella pubblica che rappresenta una cartella pubblica specifica. È inoltre possibile includere il percorso utilizzando il formato TopLevelPublicFolder\PublicFolder. È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il nome della cartella pubblica o il GUID. |
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 su cui verranno eseguite 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
Quando si esegue il cmdlet Get-PublicFolder e il valore UseDatabaseQuotaDefaults è true, vengono visualizzati i seguenti valori con i valori del database da Get-PublicFolderDatabase:
MaxItemSize
IssueWarningQuota
ProhibitPostQuota
Inoltre, ad ogni valore viene aggiunta la stringa "(InheritFromDB)".