Get-MailboxSearch

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-MailboxSearch per visualizzare le ricerche nelle cassette postali in corso, completate o arrestate.

Nota: a partire da ottobre 2020, i cmdlet *-MailboxSearch vengono ritirati in Exchange Online PowerShell. Usare invece i cmdlet *-ComplianceSearch in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere Ritiro degli strumenti legacy di eDiscovery.

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

Sintassi

Get-MailboxSearch
   [[-Identity] <SearchObjectIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   [[-Identity] <EwsStoreObjectIdParameter>]
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   -InPlaceHoldIdentity <String>
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

In Exchange locale viene usata una ricerca nella cassetta postale per eseguire un In-Place eDiscovery o per inserire gli utenti in un blocco In-Place. Usare il cmdlet Get-MailboxSearch per ottenere dettagli relativi a qualunque tipo di cassetta postale di ricerca.

È 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-MailboxSearch -ResultSize "unlimited"

In questo esempio si ottiene un elenco di tutte le ricerche delle cassette postali.

Esempio 2

Get-MailboxSearch "Project Hamilton" | Format-List

In questo esempio si ottengono tutte le proprietà della cassetta postale di ricerca Project Hamilton.

Il parametro Identity è un parametro posizionale. I parametri posizionali possono essere utilizzati senza l'etichetta (Identity). Per altre informazioni sui parametri posizionazionali, vedere Informazioni sui parametri.

Esempio 3

(Get-Mailbox Mark).InPlaceHolds

Get-MailboxSearch -InPlaceHoldIdentity 9953d0f0fd03415e949d4b41c5a28cbb

In questo esempio si ottengono le archiviazioni sul posto nelle quali è posizionato l'utente. Il primo comando restituisce GUID di blocchi In-Place. L'ultimo comando recupera una ricerca nella cassetta postale in base al GUID della In-Place Blocco su cui è inserito l'utente.

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

-Identity

Il parametro Identity indica il nome della query di ricerca. Se non viene fornito un nome, tutte le query di ricerca delle cassette postali vengono restituite.

Per migliorare le prestazioni di questo cmdlet in Exchange Online, alcune proprietà di ricerca delle cassette postali non vengono restituite se non si specifica il nome di una ricerca nella cassetta postale. Di seguito, tali proprietà:

  • SourceMailboxes
  • Origini
  • SearchQuery
  • ResultsLink
  • PreviewResultsLink
  • Errori

Per visualizzare queste proprietà, occorre fornire il nome di una cassetta postale di ricerca.

Type:SearchObjectIdParameter
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, Exchange Online

-InPlaceHoldIdentity

Il parametro InPlaceHoldIdentity specifica il GUID di una archiviazione sul posto. Usare questo parametro per cercare una archiviazione sul posto nella quale è posizionato un utente. I GUID di tutte le archiviazioni sul posto nelle quali è posizionato un utente vengono aggiunti alla proprietà utente InPlaceHolds. È possibile ottenere questa proprietà utilizzando il cmdlet Get-Mailbox.

Type:String
Position:Named
Default value:None
Required:True
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. 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ShowDeletionInProgressSearches

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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.