Get-MailboxStatistics
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Get-MailboxStatistics per restituire informazioni su una cassetta postale, ad esempio le dimensioni della cassetta postale, il numero di messaggi in esso contenuti e l'ultima volta che è stato eseguito l'accesso. Inoltre, è possibile ottenere la cronologia di spostamento o un rapporto di spostamento di una richiesta di spostamento completata.
Nota: in Exchange Online PowerShell è consigliabile usare il cmdlet Get-EXOMailboxStatistics anziché questo cmdlet. Per ulteriori informazioni, vedere Connessione a Exchange Online PowerShell.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-MailboxStatistics
-Database <DatabaseIdParameter>
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
-Server <ServerIdParameter>
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludePassive]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] Descrizione
Solo sui server Cassette postali, è possibile utilizzare il cmdlet Get-MailboxStatistics senza parametri. In questo caso, il cmdlet restituisce le statistiche per tutte le cassette postali di ogni database del server locale.
Il cmdlet Get-MailboxStatistics richiede il completamento di almeno uno dei parametri seguenti: Server, Database o Identity.
È possibile utilizzare il cmdlet Get-MailboxStatistics per restituire la cronologia di spostamento dettagliata e un rapporto di spostamento per le richieste di spostamento completate per la risoluzione di problemi relativi a una richiesta di spostamento. Per visualizzare la cronologia di spostamento, è necessario passare questo cmdlet come oggetto. Le cronologie di spostamento vengono mantenute nel database delle cassette postali e numerato in modo incrementale e l'ultima richiesta di spostamento eseguita è sempre numerato 0. Per ulteriori informazioni, vedere "Esempio 7," "Esempio 8" e "Esempio 9" più avanti in questo argomento.
È possibile visualizzare solo i rapporti di spostamento e la cronologia di spostamento per le richieste di spostamento completate.
È 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-MailboxStatistics -Identity AylaKolQuesto esempio consente di recuperare le statistiche della cassetta postale dell'utente Ayla Kol usando l'alias associato AylaKol.
Esempio 2
Get-MailboxStatistics -Server MailboxServer01In questo esempio vengono richiamate le statistiche delle cassette postali per tutte le cassette postali sul server MailboxServer01.
Esempio 3
Get-MailboxStatistics -Identity contoso\chrisIn questo esempio vengono illustrate le statistiche per la cassetta postale specificata.
Esempio 4
Get-MailboxStatistics -Database "Mailbox Database"In questo esempio vengono illustrate le statistiche per tutte le cassette postali nel database delle cassette postali specificato.
Esempio 5
Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'Questo esempio consente di recuperare le statistiche per le cassette postali disconnesse in tutti i database di cassette postali dell'organizzazione. L'operatore -ne significa "diverso da".
Esempio 6
Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742dQuesto esempio consente di recuperare le statistiche per una singola cassetta postale disconnessa. Il valore del parametro StoreMailboxIdentity corrisponde al GUID della cassetta postale disconnessa. È inoltre possibile utilizzare la LegacyDN.
Esempio 7
Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-ListIn questo esempio viene restituita la cronologia di spostamento di riepilogo per la richiesta di spostamento completata per la cassetta postale di Ayla Kol. Se non si crea una pipeline dell'output al cmdlet Format-List, la cronologia di spostamento non viene visualizzata.
Esempio 8
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]In questo esempio viene restituita la cronologia di spostamento dettagliata per la richiesta di spostamento completata per la cassetta postale di Ayla Kol. In questo esempio viene utilizzata una variabile temporanea per memorizzare l'oggetto delle statistiche delle cassette postali. Se la cassetta postale è stata spostata più volte, esisteranno più rapporti di spostamento. L'ultimo rapporto di spostamento è sempre MoveReport[0].
Esempio 9
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csvIn questo esempio viene restituita la cronologia di spostamento dettagliata e un rapporto di spostamento dettagliato per la cassetta postale di Ayla Kol. In questo esempio viene utilizzata una variabile temporanea per memorizzare l'oggetto delle statistiche delle richieste di spostamento e restituire il rapporto di spostamento in un file CSV.
Parametri
-Archive
L'opzione Archivio specifica se restituire le statistiche delle cassette postali per la cassetta postale di archiviazione associata alla cassetta postale. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| 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 |
-CopyOnServer
Questo parametro è disponibile solo in Exchange locale.
Il parametro CopyOnServer viene utilizzato per recuperare le statistiche da una copia di database specifica nel server specificato.
È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- DN legacy di Exchange
DN legacy di Exchange
| Type: | ServerIdParameter |
| 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 |
-Database
Questo parametro è disponibile solo in Exchange locale.
Il parametro Database restituisce statistiche per tutte le cassette postali nel database specificato. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Questo parametro accetta l'immissione in pipeline dal cmdlet Get-MailboxDatabase.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
-Filter
Questo parametro è disponibile solo in Exchange locale.
Il parametro Filter usa la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'".
- Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio,
$true,$falseo$null), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili. - La proprietà è una proprietà filtrabile.
- ComparisonOperator è un operatore di confronto OPATH, ad esempio
-eqper equals e-likeper il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators. - Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole (
'Value'o'$Variable'). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di'$User', usare'$($User -Replace "'","''")'. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare500,$true,$falseo$null.
È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".
Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Informazioni aggiuntive sulla sintassi OPATH.
Ad esempio, per visualizzare tutte le cassette postali disconnesse in un database di cassette postali specifico, usare la sintassi seguente: 'DisconnectDate -ne $null'.
| Type: | String |
| 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 |
-Identity
Il parametro Identity consente di specificare la cassetta postale per cui si desidera restituire le statistiche. È 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: | GeneralMailboxOrMailUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeMoveHistory
L'opzione IncludeMoveHistory specifica se restituire informazioni aggiuntive sulla cassetta postale che includano la cronologia di una richiesta di spostamento completata, come lo stato, i flag, il database di destinazione, gli elementi danneggiati, le indicazioni temporali di inizio e fine, la durata delle varie fasi della richiesta di spostamento e i codici di errore. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| 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 |
-IncludeMoveReport
L'opzione IncludeMoveReport specifica se restituire un rapporto di spostamento dettagliato per una richiesta di spostamento completata, come le connessioni al server e le fasi di spostamento. Con questa opzione non è necessario specificare alcun valore.
Poiché l'output di questo comando è dettagliato, è necessario inviare l'output in un file .CSV per un'analisi semplificata.
| Type: | SwitchParameter |
| 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 |
-IncludePassive
Questo parametro è disponibile solo in Exchange locale.
L'opzione IncludePassive specifica se restituire statistiche da tutte le copie attive e passive del database. Con questa opzione non è necessario specificare alcun valore.
Se non si usa questa opzione, il comando recupera solo le statistiche dalle copie attive del database.
| 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 |
-IncludeQuarantineDetails
Questo parametro è disponibile solo in Exchange locale.
L'opzione IncludeQuarantineDetails specifica se restituire ulteriori dettagli sulla quarantena sulla cassetta postale non incluse nei risultati. È possibile utilizzare i dettagli per determinare quando e perché la cassetta postale è stata sottoposta a quarantena. Con questa opzione non è necessario specificare alcun valore.
In particolar modo, tale opzione restituisce i valori delle proprietà QuarantineDescription, QuarantineLastCrash e QuarantineEnd sulla cassetta postale. Per visualizzare questi valori, è necessario utilizzare un cmdlet di formattazione. Ad esempio, Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*.
| 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 |
-IncludeSoftDeletedRecipients
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione IncludeSoftDeletedRecipients specifica se includere cassette postali eliminate temporaneamente nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le cassette postali eliminate temporaneamente possono essere ancora recuperate.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-NoADLookup
Questo parametro è disponibile solo in Exchange locale.
L'opzione NoADLookup specifica che le informazioni vengono recuperate dal database delle cassette postali e non da Active Directory. Con questa opzione non è necessario specificare alcun valore.
Questa opzione consente di migliorare le prestazioni dei cmdlet durante l'esecuzione di query su un database di cassette postali che contiene un numero elevato di cassette postali.
| 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 |
-Server
Questo parametro è disponibile solo in Exchange locale.
Il parametro Server consente di specificare il server da cui si desidera ottenere le statistiche delle cassette postali. È possibile utilizzare uno dei valori che seguono:
- Nome dominio completo (FQDN)
- Nome NetBIOS
Quando si specifica un valore per il parametro Server, il comando restituisce le statistiche per tutte le cassette postali di ciascun database, compresi i database di ripristino, sul server specificato. Se non si specifica questo parametro, il comando restituisce le statistiche di accesso per il server locale.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StoreMailboxIdentity
Questo parametro è disponibile solo in Exchange locale.
Il parametro StoreMailboxIdentity specifica l'identità della cassetta postale quando viene usate con il parametro Database per restituire le statistiche per una singola cassetta postale in un database specificato. È possibile utilizzare uno dei valori che seguono:
- MailboxGuid
- LegacyDN
Utilizzare questa sintassi per recuperare informazioni sulle cassette postali disconnesse, che non hanno un oggetto Active Directory corrispondente o che dispone di un oggetto Active Directory corrispondente che non punta alla cassetta postale disconnessa nel database delle cassette postali.
| Type: | StoreMailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.