Search-Mailbox

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.

Utilizzare il cmdlet Search-Mailbox per cercare una cassetta postale e copiare i risultati in una cassetta postale di destinazione specificata, eliminare i messaggi dalla cassetta postale di origine o entrambe le operazioni.

Nota: negli ambienti basati sul cloud, il cmdlet Search-Mailbox viene deprecato a favore di New-ComplianceSearch e dei cmdlet di eDiscovery correlati.

Per impostazione predefinita, Search-Mailbox è disponibile solo nei ruoli Ricerca cassette postali o Esportazione importazione cassette postali e questi ruoli non sono assegnati ad alcun gruppo di ruoli. Per usare questo cmdlet, è necessario aggiungere uno o entrambi i ruoli a un gruppo di ruoli, ad esempio il gruppo di ruoli Gestione organizzazione. Solo il ruolo Importazione esportazione cassette postali consente di accedere al parametro DeleteContent. Per altre informazioni sull'aggiunta di ruoli ai gruppi di ruoli, vedere Aggiungere un ruolo a un gruppo di ruoli.

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

Sintassi

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-EstimateResultOnly]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      -TargetFolder <String>
      -TargetMailbox <MailboxIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-LogLevel <LoggingLevel>]
      [-LogOnly]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Descrizione

È possibile utilizzare il cmdlet Search-Mailbox per cercare i messaggi in una cassetta postale specificata ed eseguire una delle seguenti attività:

• Copiare i messaggi in una cassetta postale di destinazione specificata.
• Eliminare i messaggi dalla cassetta postale di origine. Per eliminare i messaggi, è necessario disporre del ruolo di gestione Esportazione/importazione delle cassette postali.
• Eseguire il ripristino di un singolo elemento per ripristinare gli elementi dalla cartella Elementi recuperabili di un utente.
• Pulire la cartella Elementi recuperabili per una cassetta postale quando ha raggiunto la quota rigida di Elementi recuperabili.

Esempio

Esempio 1

Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full

In questo esempio viene eseguita la ricerca della cassetta postale di Joe Healy e tutti i risultati della ricerca vengono copiati nella cassetta postale di individuazione nella cartella JoeHealy-ProjectHamilton.

Esempio 2

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

Con questo esempio viene effettuata una ricerca nella cassetta postale di April Stewart per individuare i messaggi contenenti la frase "Your bank statement" nell'oggetto e il risultato viene registrato nella cartella SearchAndDeleteLog della cassetta postale dell'amministratore. I messaggi non vengono copiati nella cassetta postale di destinazione.

Esempio 3

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent

Con questo esempio viene effettuata una ricerca nella cassetta postale di April Stewart per individuare i messaggi contenenti la frase "Your bank statement" nell'oggetto; tali messaggi vengono eliminati dalla cassetta postale di origine. Per utilizzare l'opzione DeleteContent è necessario disporre del ruolo di gestione Esportazione/importazione delle cassette postali.

Esempio 4

Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full

In questo esempio vengono cercati i messaggi contenenti la parola "election", "candidate" o "vote" in tutte le cassette postali dell'organizzazione. I risultati della ricerca vengono copiati nella cartella AllMailboxes-Election della cassetta postale dei risultati di ricerca.

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

-DeleteContent

Nota: per usare questa opzione è necessario assegnare il ruolo di gestione Importazione esportazione cassette postali. Per impostazione predefinita, questo ruolo non è assegnato ad alcun gruppo di ruoli (inclusa la gestione dell'organizzazione). In genere, si assegna un ruolo a un gruppo di ruoli incorporato o personalizzato.

L'opzione DeleteContent consente di specificare che i messaggi restituiti dalla ricerca devono essere eliminati definitivamente dalla cassetta postale di origine. Con questa opzione non è necessario specificare alcun valore.

Quando si usa questa opzione con il parametro TargetMailbox, i messaggi vengono copiati nella cassetta postale di destinazione e rimossi dalla cassetta postale di origine. Se si imposta il livello di registrazione per la ricerca su Basic o Full, è necessario specificare una cassetta postale e una cartella di destinazione in cui inserire il registro. Per eliminare i messaggi dalla cassetta postale di origine senza copiarli nella cassetta postale di destinazione, non specificare i parametri TargetMailbox, TargetFolder e LogLevel.

Prima di utilizzare l'opzione DeleteContent per eliminare il contenuto, si consiglia di testare i parametri di ricerca utilizzando il parametro LogOnly, come mostrato nell'Esempio 2.

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

-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

-DoNotIncludeArchive

Il parametro DoNotIncludeArchive consente di specificare che la cassetta postale di archivio dell'utente non deve essere inclusa nella ricerca. Non è necessario specificare un valore per questa opzione.

Per impostazione predefinita, la cassetta postale di archiviazione è sempre inclusa nella ricerca.

Se l'archiviazione a espansione automatica è abilitata per una cassetta postale Exchange Online, viene eseguita la ricerca solo nella cassetta postale di archiviazione primaria dell'utente. Le cassette postali di archiviazione ausiliarie sono escluse dalla ricerca.

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

-EstimateResultOnly

L'opzione EstimateResultOnly restituisce solo una stima del numero totale e delle dimensioni dei messaggi. I messaggi non vengono copiati nella cassetta postale di destinazione. Con questa opzione non è necessario specificare alcun valore.

Non è possibile utilizzare questa opzione con il parametro TargetMailbox.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Force

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

Usare questa opzione per nascondere la richiesta di conferma quando si usa l'opzione DeleteContent per eliminare definitivamente i messaggi.

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 l'identità della cassetta postale da ricercare. È 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:	MailboxOrMailUserIdParameter
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

-IncludeUnsearchableItems

L'opzione IncludeUnsearchableItems include elementi che non possono essere indicizzati da Ricerca di Exchange nei risultati della ricerca. 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

-LogLevel

Il parametro LogLevel consente di specificare il livello di registrazione per la ricerca. Può avere uno dei seguenti valori:

• Elimina: non vengono conservati log.
• Basic: vengono mantenute le informazioni di base sulla query e su chi l'ha eseguita.
• Completo: oltre alle informazioni mantenute dal livello di log Basic, il livello di log completo aggiunge un elenco completo dei risultati della ricerca.

Il livello di registrazione predefinito è Basic.

Quando è stato incluso questo parametro, viene creato e inviato un messaggio di posta elettronica alla cassetta postale specificata dal parametro TargetMailbox. Il file di log (che è un file in formato CSV denominato Search Results.csv) è collegato a questo messaggio di posta elettronica e si troverà nella cartella specificata dal parametro TargetFolder. Il file di registro contiene una riga per ogni messaggio incluso nei risultati della ricerca quando si esegue il cmdlet Search-Mailbox.

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

-LogOnly

L'opzione LogOnly esegue una ricerca, ma genera solo un log. I messaggi restituiti dalla ricerca non vengono copiati nella cassetta postale di destinazione. Con questa opzione non è necessario specificare alcun valore.

Il livello di registrazione viene specificato utilizzando il parametro LogLevel.

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

-SearchDumpster

L'opzione SearchDumpster specifica se includere la cartella Elementi ripristinabili nella ricerca. La cartella Elementi ripristinabili archivia gli elementi eliminati dalla cartella Posta eliminata o gli elementi che sono stati eliminati definitivamente fino a quando non vengono eliminati dal database delle cassette postali.

Per impostazione predefinita, la cartella Elementi ripristinabili è sempre inclusa nella ricerca. Per escludere la cartella Elementi ripristinabili dalla ricerca, usare questa sintassi esatta: -SearchDumpster:$false.

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

-SearchDumpsterOnly

L'opzione SearchDumpsterOnly specifica che viene eseguita la ricerca solo nella cartella Elementi ripristinabili della cassetta postale specificata. Con questa opzione non è necessario specificare alcun valore.

La cartella Elementi ripristinabili archivia gli elementi eliminati dalla cartella Posta eliminata o gli elementi che sono stati eliminati definitivamente fino a quando non vengono eliminati dal database delle cassette postali.

Questa opzione può essere utilizzata anche con l'opzione DeleteContent per eliminare i messaggi dalla cartella degli elementi recuperabili e ridurre la dimensione della cartella.

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

-SearchQuery

Il parametro SearchQuery consente di specificare una stringa di ricerca o una query formattata utilizzando Keyword Query Language (KQL). Per altre informazioni su KQL in Exchange, vedere Proprietà dei messaggi e operatori di ricerca per In-Place eDiscovery.

Se questo parametro è vuoto, vengono restituiti tutti i messaggi.

Nota: il cmdlet Search-Mailbox restituisce fino a 10000 risultati per cassetta postale se viene specificata una query di ricerca.

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

-TargetFolder

Il parametro TargetFolder consente di specificare un nome di cartella in cui salvare i risultati della ricerca nella cassetta postale di destinazione. La cartella viene creata nella cassetta postale di destinazione al momento dell'esecuzione.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetMailbox

Il parametro TargetMailbox consente di specificare la cassetta postale di destinazione in cui vengono copiati i risultati della ricerca. È 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)

È necessario usare questo parametro con il parametro TargetFolder. Non è possibile utilizzare questo parametro con l'opzione EstimateResultOnly.

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, 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.