Get-MailboxFolder
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
Utilizzare il cmdlet Get-MailboxFolder per visualizzare le cartelle della propria cassetta postale. Gli amministratori non possono usare questo cmdlet per visualizzare le cartelle in altre cassette postali (il cmdlet è disponibile solo dal ruolo utente MyBaseOptions).
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
GetChildren
Get-MailboxFolder
[[-Identity] <MailboxFolderIdParameter>]
[-GetChildren]
[-DomainController <Fqdn>]
[-MailFolderOnly]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Recurse
Get-MailboxFolder
[[-Identity] <MailboxFolderIdParameter>]
[-Recurse]
[-DomainController <Fqdn>]
[-MailFolderOnly]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Descrizione
Questo comando verifica che la cassetta postale specificata nel parametro Identity sia una cassetta postale di Exchange valida prima di recuperare le cartelle richieste. Se non viene specificato l'opzione MailFolderOnly, il cmdlet restituisce tutte le cartelle.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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-MailboxFolder -Identity :\Inbox | Format List
In questo esempio vengono restituite informazioni dettagliate sulla cartella Posta in arrivo nella propria cassetta postale.
Esempio 2
Get-MailboxFolder
In questo esempio viene restituito un elenco riepilogativo delle cartelle radice nella propria cassetta postale.
Esempio 3
Get-MailboxFolder -GetChildren -MailFolderOnly
In questo esempio viene restituito il primo livello di cartelle di posta nella propria cassetta postale.
Esempio 4
Get-MailboxFolder -Identity :\Inbox -GetChildren
In questo esempio vengono restituite informazioni su tutte le sottocartelle in Posta in arrivo nella propria cassetta postale.
Esempio 5
Get-MailboxFolder -Identity :\Inbox -Recurse
In questo esempio viene restituito un elenco riepilogativo di tutti i livelli di cartelle in Posta in arrivo nella propria cassetta postale.
Parametri
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-GetChildren
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione GetChildren specifica se restituire solo il primo livello di sottocartelle della cartella principale specificata. Con questa opzione non è necessario specificare alcun valore.
Non è possibile utilizzare questa opzione con quella Recurse.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
GetChildren
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro Identity consente di specificare la cartella cassetta postale che si desidera visualizzare. La sintassi è [MailboxID]:[\ParentFolder][\SubFolder].
È possibile eseguire questo cmdlet solo nella propria cassetta postale, quindi non è necessario (o non può) specificare un MailboxID valore.
Per il valore di MailboxID, è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\Nome utente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
Se non viene specificata la cartella, il comando restituisce informazioni sulle cartelle nella gerarchia principale della cassetta postale specificata.
I valori di esempio per questo parametro sono john@contoso.com:, John:\Inbox.
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se fosse stato eseguito il comando Get- senza il parametro Identity. Verificare che gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | MailboxFolderIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MailFolderOnly
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione MailFolderOnly specifica se restituire solo le cartelle di posta elettronica nella cassetta postale specificata. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Recurse
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione Recurse specifica se restituire la cartella principale specificata e tutte le relative sottocartelle. Con questa opzione non è necessario specificare alcun valore.
Non è possibile utilizzare questa opzione con quella GetChildren.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Recurse
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ResultSize
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.