Visualizzazione post con etichetta Get-PublicFolder. Mostra tutti i post
Visualizzazione post con etichetta Get-PublicFolder. Mostra tutti i post

mercoledì 20 luglio 2022

MS Exchange: Visualizzare informazioni sulle Public Folders con Get-PublicFolder

Per recuperare gli attributi di una cartella pubblica o di un insieme di cartelle pubbliche è possibile utilizzare il cmdlet Get-PublicFolder, disponibile sia in Exchange on-premises che Exchange on-cloud (alcuni parametri e impostazioni possono essere esclusivi di un ambiente o dell'altro).

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

Parametri

-DomainController
Questo parametro è disponibile solo in Exchange on-premises.
Il parametro DomainController specifica il controller di dominio utilizzato da questo cmdlet per leggere dati da o scrivere dati su Active Directory. Il controller di dominio viene identificato con il suo Fully Qualified Domain Name (FQDN). Ad esempio, dc01.contoso.com.

-GetChildren
L'opzione GetChildren specifica se restituire solo i figli della cartella specificata dal parametro Identity. Non è necessario specificare un valore con questo parametro e non è possibile utilizzarlo con i parametri Recurse o LostAndFound.

-Identity
Il parametro Identity specifica il nome e il percorso della cartella pubblica che si desidera visualizzare. Un valore valido utilizza la sintassi: \Livello1\Livello2\...\LivelloN\PublicFolder. Ad esempio, "\Clienti Italia" o "\Clienti\Clienti Italia".

-LostAndFound
Permette di specificare se restituire solo le cartelle orfane che si trovano in \NON_IPM_SUBTREE\LOST_AND_FOUND. Non è necessario passare un valore a questo parametro
La cartella LOST_AND_FOUND contiene le cartelle mancanti che vengono ricreate dal processo di riconciliazione della gerarchia delle cartelle pubbliche quando la cartella esiste in una mailbox cartelle pubbliche secondaria, ma non in quella primaria.

Non è possibile utilizzare questo parametro insieme a -Identity o -Recurse.

-Mailbox
Il parametro Mailbox specifica l'identità della mailbox cartella pubblica gerarchica. È possibile utilizzare qualsiasi valore che identifichi in modo univoco la mailbox. Ad esempio:
  • Name
  • Alias
  • Distinguished name (DN)
  • Canonical DN
  • Domain\Username
  • Email address
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • User ID or user principal name (UPN)

-Organization
Questo parametro è disponibile solo in Exchange on-premises ed è riservato all'uso interno di Microsoft.

-Recurse
L'opzione Recurse specifica se restituire la cartella pubblica specificata e tutti i suoi figli. Non è possibile utilizzare questo parametro insieme a -GetChildren o -LostAndFound.

-ResidentFolders
Specifica se restituire le cartelle pubbliche che risiedono in una determinata mailbox delle cartelle pubbliche di contenuto. Se non si utilizza questo parametro, il comando restituirà solo le cartelle pubbliche il cui contenuto risiede nella mailbox delle cartelle pubbliche della gerarchia primaria.

-ResultSize
Il parametro ResultSize specifica il numero massimo di risultati da restituire. Il massimo predefinito è 10.000. Per non avere limiti ai risultati restituiti, impostare questo parametro su Unlimited. Questo parametro può essere passato solo in combinazione con i parametri -Recurse o -GetChildren.

-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 univocamente il server. Ad esempio:
  • Name
  • FQDN
  • Distinguished name (DN)
  • Exchange Legacy DN


Esempi

Esempio 1
Get-PublicFolder
Questo esempio utilizza il comando Get-PublicFolder senza parametri per restituire l'oggetto cartella pubblica principale (IPM_SUBTREE).

Esempio 2
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
Questo esempio restituisce i nomi di tutte le cartelle di sistema (che non sono mostrate per impostazione predefinita), a partire dalla radice della cartella di sistema (\NON_IPM_SUBTREE).

Esempio 3
Get-PublicFolder -Identity "\Ufficio1\Documenti" -Recurse -ResultSize Unlimited
Questo esempio restituisce la cartella pubblica "Documenti" da "\Ufficio1\" e tutte le sotto cartelle, senza limiti di numero.

Esempio 4
Get-PublicFolder -Mailbox "Ufficio" -ResidentFolders
Questo esempio restituisce le cartelle pubbliche che risiedono nella casella di posta elettronica specificata

Esempio 5
Get-PublicFolder -Recurse -ResultSize Unlimited | Select Identity, Name |Export-CSV C:\Temp\ElencoPB.txt -encoding "Unicode" -notypeinformation
Restituisce l'elenco delle cartelle (nome e percorso) contenute nelle cartelle pubbliche e lo esporta all'interno del file specificato.




mercoledì 17 gennaio 2018

MS Exchange: Ricerca all'interno delle Public Folders utilizzando EMS

Per recuperare gli attributi di una cartella o un insieme di cartelle pubbliche in Exchange Management Shell (EMS) è disponibile il cmdlet Get-PublicFolder.
Il cmdlet può essere utilizzato da solo oppure insieme ad uno o più parametri di seguito elencati.

Parametri principali


GetChildren
Permette di specificare se restituire solo gli elementi figlio della cartella specificata da -Identity. Non può essere utilizzato con il parametro Recurse.

Identity
Il parametro Identity permette di specificare una determinata public folder. Consente di indicare anche il path utilizzando il formato \TopLevelPublicFolder\PublicFolder.

Recurse 
Il parametro recurse specifica che il comando restituirà la cartella pubblica indicata e tutti i sui figli.

Mailbox
Il parametro Mailbox consente di specificare l'identità della casella di posta di cartelle pubbliche gerarchica. Il parametro accetta l'Alias, il Display Name, il Distinguished Name (DN) o il Domain\Account.

ResultSize
Con ResultSize è possibile specificare il numero massimo di risultati da restituire. Il valore massimo predefinito è 10.000. Se non si intende impostare alcun limite al numero di risultati restituiti, al parametro va passato il valore Unlimited. Resultsize può essere specificato solo con i parametri Recurse o GetChildren.


Esempi


Esempio 1
Get-PublicFolder
Il cmdlet senza parametri restituisce la cartella pubblica radice (IPM_SUBTREE).

Esempio 2
Get-PublicFolder -Identity "\Agenzia1\Documenti\Legale"
Il comando restituisce la cartella pubblica Legale presente in \Agenzia1\Documenti\. Per visualizzare anche il contenuto delle sottocartelle di Legale è possibile utilizzare il parametro -Recurse come indicato di seguito
Get-PublicFolder -Identity "\Agenzia1\Documenti\Legale" -Recurse

Esempio 3
Get-PublicFolder -Mailbox "Ufficio1" -ResidentFolders
Restituisce le cartelle pubbliche che risiedono nella cartella pubblica della casella Ufficio1.

Esempio 4
Get-PublicFolder -recurse -resultsize unlimited | where {$_.name -like "sala*"}
Ricerca le cartelle il cui nome inizia per sala all'interno delle cartelle pubbliche.


Get-PublicFolder, ricerca cartelle pubbliche
FIG 1 - Get-PublicFolder, ricerca cartelle pubbliche