Search-Mailbox

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.

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.

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.

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.

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.

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.

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)

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.

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.

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.

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.

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.

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.

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.

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.

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.