Condividi tramite


Get-PublicFolder

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

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

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-PublicFolder

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

Esempio 2

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

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

Esempio 3

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

In questo esempio viene restituita la cartella pubblica Pending Litigation da \Legal\Documents\.

Esempio 4

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

In questo esempio vengono restituite la cartella pubblica Pending Litigation da \Legal\Documents\ e tutte le sottocartelle pubbliche nella cartella pubblica Pending Litigation. Poiché la dimensione del risultato non è specificata, il comando può restituire il numero massimo di cartelle pubbliche, pari a 10.000.

Esempio 5

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

In questo esempio vengono restituite la cartella pubblica Pending Litigation da \Legal\Documents\ e tutte le relative sottocartelle pubbliche nella cartella pubblica Pending Litigation senza alcun limite.

Esempio 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

Con questo esempio vengono restituite le cartelle pubbliche che risiedono nella cartella pubblica della cassetta postale Ufficio legale.

Parametri

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

L'opzione GetChildren specifica se restituire solo gli elementi figlio della cartella specificata dal parametro Identity. Con questa opzione non è necessario specificare alcun valore.

Non è possibile usare questa opzione con le opzioni Recurse o 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

Il parametro Identity consente di specificare il nome e il percorso della cartella pubblica da visualizzare. Un valore valido usa la sintassi : \Level1\Level2\...\LevenN\PublicFolder. Ad esempio, "\Customer Discussion" o "\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

L'opzione LostAndFound specifica se restituire solo le cartelle orfane che si trovano in \NON_IPM_SUBTREE\LOST_AND_FOUND. Con questa opzione non è necessario specificare alcun valore.

La cartella LOST_AND_FOUND contiene cartelle mancanti che vengono ricreate dal processo di riconciliazione della gerarchia di cartelle pubbliche quando la cartella esiste in una cassetta postale di cartelle pubbliche secondarie, ma non nella cartella primaria.

Non è possibile usare questa opzione con il parametro Identity o le opzioni Recurse o 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

Il parametro Mailbox consente di specificare l'identità della cassetta postale di cartelle pubbliche gerarchica. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (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

Questo parametro è disponibile solo in Exchange locale.

Questo parametro è riservato all'uso interno da parte di 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

L'opzione Recurse specifica se restituire la cartella pubblica specificata e tutti i relativi elementi figlio. Con questa opzione non è necessario specificare alcun valore.

Non è possibile usare questa opzione con le opzioni GetChildren o 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

L'opzione ResidentFolders specifica se restituire cartelle pubbliche che risiedono in una cassetta postale di cartelle pubbliche di contenuto specifica. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, il comando restituirà solo le cartelle pubbliche il cui contenuto risiede nella cassetta postale delle cartelle pubbliche della gerarchia primaria.

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

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 questo parametro solo con i parametri Recurse o 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

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro Server filtra i risultati in base al server Exchange specificato. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • FQDN
  • Nome distinto (DN)
  • DN legacy di Exchange
Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.