Start-MailboxSearch

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Start-MailboxSearch per riavviare o riprendere una ricerca interrotta in una cassetta postale.

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

Start-MailboxSearch
     [-Identity] <SearchObjectIdParameter>
     [-Confirm]
     [-DomainController <Fqdn>]
     [-Force]
     [-Resume]
     [-StatisticsStartIndex <Int32>]
     [-WhatIf]
     [<CommonParameters>]

Descrizione

È possibile usare In-Place eDiscovery per cercare una o più cassette postali specificate o tutte le cassette postali nell'organizzazione di Exchange. Una ricerca viene creata usando l'interfaccia di amministrazione di Exchange o il cmdlet New-MailboxSearch.

Quando si riavvia una ricerca, vengono rimossi eventuali risultati restituiti dalla stessa ricerca e copiati in una cassetta postale di individuazione. Per mantenere i risultati della ricerca precedenti e riprendere la ricerca dal punto in cui è stata interrotta, utilizzare l'opzione Resume.

In Exchange 2013 o versioni successive vengono usate anche ricerche nelle cassette postali per In-Place blocco. Tuttavia, non è possibile avviare o arrestare l'archiviazione sul posto tramite i cmdlet Start-MailboxSearch e Stop-MailboxSearch.

Per altri dettagli, vedere Blocco sul posto e blocco per controversia legale in Exchange Server e In-Place eDiscovery in Exchange Server.

È 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

Start-MailboxSearch -Identity "ProjectContoso"

In questo esempio viene avviata la ricerca di cassette postali ProjectContoso.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
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

-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

-Force

L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.

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

-Identity

Il parametro Identity consente di specificare il nome della ricerca. Il nome viene specificato durante l'avvio, l'arresto o la rimozione della ricerca.

Type:SearchObjectIdParameter
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

-Resume

L'opzione Resume consente di riprendere una ricerca interrotta, non riuscita o riuscita solo parzialmente dal punto in cui è stata interrotta. Con questa opzione non è necessario specificare alcun valore.

Se si utilizza questa opzione per riprendere una ricerca, i risultati della ricerca precedente non vengono rimossi dalla cassetta postale di destinazione.

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

-StatisticsStartIndex

Il parametro StatisticsStartIndex è utilizzato da EAC per recuperare le statistiche sulle parole chiave in un'operazione di restituzione di una pagina di dati.

Type:Int32
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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
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

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.