Get-EXOMailbox
Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.
Usare il cmdlet Get-EXOMailbox per visualizzare gli oggetti e gli attributi delle cassette postali, popolare le pagine delle proprietà o fornire informazioni sulla cassetta postale ad altre attività.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-EXOMailbox
[[-Identity] <String>]
[-Archive]
[-Async]
[-ExternalDirectoryObjectId <Guid>]
[-Filter <String>]
[-GroupMailbox]
[-InactiveMailboxOnly]
[-IncludeInactiveMailbox]
[-MailboxPlan <String>]
[-Migration]
[-OrganizationalUnit <String>]
[-PrimarySmtpAddress <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-PublicFolder]
[-RecipientTypeDetails <String[]>]
[-ResultSize <Unlimited>]
[-SoftDeletedMailbox]
[-UserPrincipalName <String>]
[<CommonParameters>]Get-EXOMailbox
[-Anr <String>]
[-Archive]
[-Async]
[-Filter <String>]
[-GroupMailbox]
[-InactiveMailboxOnly]
[-IncludeInactiveMailbox]
[-MailboxPlan <String>]
[-Migration]
[-OrganizationalUnit <String>]
[-Properties <String[]>]
[-PropertySets <PropertySet[]>]
[-PublicFolder]
[-RecipientTypeDetails <String[]>]
[-ResultSize <Unlimited>]
[-SoftDeletedMailbox]
[<CommonParameters>]Descrizione
Per impostazione predefinita, questo cmdlet restituisce un elenco di riepilogo (un set minimo di proprietà) di tutte le cassette postali dell'organizzazione.
Esempio
Esempio 1
Get-EXOMailbox -ResultSize unlimitedIn questo esempio viene restituito un elenco riepilogativo di tutte le cassette postali dell'organizzazione e viene incluso il set predefinito di proprietà di output minime. Per restituire proprietà aggiuntive, usare i parametri Properties e/o PropertySets.
Esempio 2
Get-EXOMailbox -PropertySets ArchiveIn questo esempio vengono restituite le proprietà definite nel set di proprietà Archive. Per un elenco completo di queste proprietà, vedere Set di proprietà Get-EXOMailbox.
Esempio 3
Get-EXOMailbox -Properties Name,DistinguishedName,Guid -PropertySets Archive,AuditIn questo esempio viene restituito un elenco riepilogativo di tutte le cassette postali dell'organizzazione e vengono incluse le proprietà seguenti:
- Proprietà nei set di proprietà Archive e Audit.
- Proprietà Name e DistinguishedName.
Esempio 4
Get-EXOMailbox -Identity John@contoso.com -Properties DisplayName,EmailAddresses,AliasIn questo esempio vengono restituite le proprietà specificate per la cassetta postale John@contoso.com.
Parametri
-Anr
Il parametro Anr consente di specificare una stringa in cui eseguire la ricerca per la risoluzione dei nomi ambigui (ANR). È possibile specificare una stringa parziale e cercare gli oggetti con un attributo che corrisponda alla stringa. Gli attributi predefiniti ricercati sono i seguenti:
- CommonName (CN)
- DisplayName
- FirstName
- LastName
- Alias
Non è possibile usare questo parametro con i parametri ExternalDirectoryObjectId, Identity, PrimarySmtpAddress o UserPrincipalName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Archive
L'opzione Archivio filtra i risultati in base alle cassette postali per cui è abilitato un archivio (vengono restituite solo le cassette postali che dispongono di una cassetta postale di archiviazione). 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 Online |
-Async
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ExternalDirectoryObjectId
Il parametro ExternalDirectoryObjectId identifica la cassetta postale che si vuole visualizzare in base all'ObjectId in Azure Active Directory.
Non è possibile usare questo parametro con i parametri Anr, Identity, PrimarySmtpAddress o UserPrincipalName.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Filter
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. Per altre informazioni sulle proprietà filtrabili, vedere Set di proprietà Get-EXOMailbox e Proprietà filtrabili per il parametro Filter.
- 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupMailbox
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Il parametro Identity consente di specificare la cassetta postale da visualizzare. Per ottenere prestazioni ottimali, è consigliabile usare i valori seguenti:
- ID utente o Nome entità utente (UPN)
- GUID
In caso contrario, è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- LegacyExchangeDN
- SamAccountName
Non è possibile usare questo parametro con i parametri Anr, ExternalDirectoryObjectId, PrimarySmtpAddress o UserPrincipalName.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-InactiveMailboxOnly
L'opzione InactiveMailboxOnly specifica se restituire solo cassette postali inattive nei risultati. Con questa opzione non è necessario specificare alcun valore.
In una cassetta postale inattiva è stato abilitato il blocco per controversia legale o il blocco sul posto, prima che la cassetta postale venga eliminata in modo reversibile. I contenuti di una cassetta postale non attiva vengono conservati fino alla rimozione del blocco.
Per restituire sia le cassette postali attive che le cassette postali inattive nei risultati, non usare questa opzione. Usare invece l'opzione IncludeInactiveMailbox.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IncludeInactiveMailbox
L'opzione IncludeInactiveMailbox consente di specificare se includere le cassette postali inattive nei risultati. Con questa opzione non è necessario specificare alcun valore.
In una cassetta postale inattiva è stato abilitato il blocco per controversia legale o il blocco sul posto, prima che la cassetta postale venga eliminata in modo reversibile. I contenuti di una cassetta postale non attiva vengono conservati fino alla rimozione del blocco.
Per restituire solo cassette postali inattive nei risultati, non usare questa opzione. Usare invece l'opzione InactiveMailboxOnly.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MailboxPlan
Il parametro MailboxPlan consente di filtrare i risultati per piano della cassetta postale. Quando si utilizza questo parametro, nei risultati vengono restituite solo le cassette postali che sono state assegnate al piano della cassetta postale specificato. È possibile utilizzare qualsiasi valore che identifichi il piano della cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome visualizzato
- Nome distinto (DN)
- GUID
Il piano della cassetta postale consente di specificare le autorizzazioni e le funzionalità disponibili per l'utente di una cassetta postale nelle organizzazioni basate su cloud. È possibile visualizzare i piani delle cassette postali disponibili utilizzando il cmdlet Get-MailboxPlan.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Migration
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-OrganizationalUnit
Il parametro OrganizationalUnit filtra i risultati in base alla posizione dell'oggetto in Active Directory. Vengono restituiti solo gli oggetti presenti nella posizione specificata. L'input valido per questo parametro è un'unità organizzativa (OU) o un dominio visibile utilizzando il cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:
- Nome
- Nome
- Nome distinto (DN)
- GUID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrimarySmtpAddress
PrimarySmtpAddress identifica la cassetta postale che si desidera visualizzare in base all'indirizzo di posta elettronica SMTP primario , navin@contoso.comad esempio .
Non è possibile usare questo parametro con i parametri Anr, ExternalDirectoryObjectId, Identity o UserPrincipalName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Properties
Il parametro Properties consente di specificare le proprietà restituite nell'output di questo cmdlet. È possibile specificare più valori separati da virgole.
Per altre informazioni sulle proprietà disponibili, vedere Set di proprietà Get-EXOMailbox.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PropertySets
Il parametro PropertySets specifica un raggruppamento logico di proprietà restituite nell'output di questo cmdlet. I valori validi sono:
- Tutti
- Minimo (questo è il valore predefinito)
- AddressList
- Archiviare
- Audit
- Personalizzato
- Recapito
- Hold
- Moderazione
- Move
- Criteri
- PublicFolder
- Quota
- Risorsa
- Conservazione
- SCL
- SoftDelete
- StatisticsSeed
È possibile specificare più valori separati da virgole.
Per altre informazioni sulle proprietà incluse in ogni set di proprietà, vedere Set di proprietà Get-EXOMailbox.
| Type: | PropertySet[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PublicFolder
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RecipientTypeDetails
Il parametro RecipientTypeDetails filtra i risultati in base al sottotipo di cassetta postale specificato. I valori validi sono:
- DiscoveryMailbox
- EquipmentMailbox
- GroupMailbox
- LegacyMailbox
- LinkedMailbox
- LinkedRoomMailbox
- RoomMailbox
- SchedulingMailbox
- SharedMailbox
- TeamMailbox
- UserMailbox
È possibile specificare più valori separati da virgole.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SoftDeletedMailbox
L'opzione SoftDeletedMailbox è necessaria per restituire 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 |
-UserPrincipalName
Il parametro UserPrincipalName identifica la cassetta postale che si desidera visualizzare in base all'UPN, navin@contoso.onmicrosoft.comad esempio .
Non è possibile usare questo parametro con i parametri Anr, ExternalDirectoryObjectId, Identity o PrimarySmtpAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Input
Input types
I parametri di Get-Mailbox seguenti non sono disponibili o funzionano in Get-EXOMailbox:
- Async
- GroupMailbox
- Migrazione
- PublicFolder
- SortBy
Output
Output types
Nell'output di Get-EXOMailbox non sono incluse le proprietà seguenti:
- RunspaceId
- Nomeserver
- AdminDisplayVersion
- DelayReleaseHoldApplied
- EnforcedTimestamps
- Descrizione
- OriginatingServer
- IsValid
- ObjectState