Set-MailboxSearch

Il parametro AllPublicFolderSources indica se includere nella ricerca tutte le cartelle pubbliche dell'organizzazione. I valori validi sono:

• $true: tutte le cartelle pubbliche sono incluse nella ricerca. Questo valore è obbligatorio quando il valore del parametro AllSourceMailboxes è $falseand non si specifica una o più cassette postali di origine usando il parametro SourceMailboxes (il valore del parametro è vuoto [$null]).
• $false: nella ricerca non sono incluse cartelle pubbliche. Questo è il valore predefinito. È possibile usare questo valore quando il valore del parametro AllSourceMailboxes è $trueor si specifica una o più cassette postali di origine usando il parametro SourceMailboxes (il valore del parametro non è vuoto [$null]).

Il parametro AllSourceMailboxes consente di specificare se includere nella ricerca tutte le cassette postali. I valori validi sono:

• $true: tutte le cassette postali sono incluse nella ricerca. Questo valore è obbligatorio quando il valore del parametro AllPublicFolderSources è $falseand non si specifica una o più cassette postali di origine usando il parametro SourceMailboxes (il valore del parametro è vuoto [$null]).
• $false: tutte le cassette postali non sono incluse nella ricerca. Questo è il valore predefinito. È possibile utilizzare questo valore quando il valore del parametro AllPublicFolderSources è $trueor si specifica una o più cassette postali di origine usando il parametro SourceMailboxes (il valore del parametro non è vuoto [$null]).

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.

Il parametro Description consente di specificare una descrizione della ricerca. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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.

Questo parametro è disponibile solo in Exchange Server 2010.

L'opzione DoNotIncludeArchive esclude gli elementi nella cassetta postale di archiviazione dell'utente dalle ricerche delle cassette postali. Con questa opzione non è necessario specificare alcun valore.

Per impostazione predefinita, gli elementi nella cassetta postale di archiviazione dell'utente sono inclusi nelle ricerche delle cassette postali.

Il parametro EndDate consente di specificare la data di fine dell'intervallo di date.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Per cancellare la data di fine, usare il valore $null.

L'opzione EstimateOnly fornisce solo una stima del numero di elementi che verranno restituiti senza copiare il messaggio nella cassetta postale di destinazione. Con questa opzione non è necessario specificare alcun valore.

Il parametro ExcludeDuplicateMessages consente di eliminare i messaggi duplicati nelle cassette postali durante una ricerca In-Place eDiscovery. I valori validi sono:

• $true: copiare una singola istanza di un messaggio se lo stesso messaggio esiste in più cartelle o cassette postali. Questo è il valore predefinito.
• $false: copia tutte le istanze di un messaggio se lo stesso messaggio esiste in più cartelle o cassette postali.

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 che indica che i risultati della ricerca precedente verranno rimossi dalla cassetta postale di destinazione e che la ricerca verrà riavviata.

Il parametro Identity consente di specificare il nome della ricerca nella cassetta postale che si desidera modificare. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

L'opzione IncludeKeywordStatistics restituisce statistiche sulle parole chiave (numero di istanze per ogni parola chiave). Con questa opzione non è necessario specificare alcun valore.

Il parametro IncludeUnsearchableItems specifica se gli elementi che non possono essere indicizzati da Ricerca di Exchange devono essere inclusi nei risultati. I valori validi sono:

• $true: i risultati includono elementi non ricercabili.
• $false: gli elementi non ricercabili non sono inclusi nei risultati. Questo è il valore predefinito.

Gli elementi non ricercabili non vengono conservati per una archiviazione sul posto basata su query. Se gli elementi non ricercabili devono essere conservati, è necessario creare una conservazione indefinita (ovvero una conservazione in cui non vengono specificati parametri di ricerca per ottenere una funzionalità simile alla conservazione per controversia legale.

Il parametro InPlaceHoldEnabled consente di specificare se impostare il blocco sul posto per gli elementi dei risultati della ricerca. I valori validi sono:

• $true: In-Place blocco è abilitato nei risultati della ricerca.
• $false: In-Place blocco non è abilitato nei risultati della ricerca. Questo è il valore predefinito.

Non è possibile impostare il blocco sul posto per i risultati della ricerca, quando il parametro AllSourceMailboxes è $true.

Se si tenta di inserire un blocco ma non si specificano cassette postali usando il parametro SourceMailboxes, il comando potrebbe avere esito positivo, ma le cassette postali non vengono inserite in In-Place blocco.

Il parametro ItemHoldPeriod consente di specificare il numero di giorni per l'In-Place blocco degli elementi della cassetta postale (tutti gli elementi o gli elementi della cassetta postale restituiti nei risultati della query di ricerca). Usare questo parametro con il parametro InPlaceHoldEnabled per impostare un In-Place Hold. La durata viene calcolata dal momento di ricezione o creazione dell'elemento nella cassetta postale. I valori validi sono:

• Un numero intero.
• Valore illimitato. Questo è il valore predefinito. Gli elementi vengono mantenuti finché non si rimuove il blocco In-Place rimuovendo la ricerca tramite il cmdlet Remove-MailboxSearch, rimuovendo la cassetta postale di origine dalla ricerca usando il cmdlet Set-MailboxSearch e il parametro SourceMailboxes oppure in Exchange locale, rimuovere tutte le cartelle pubbliche dalla ricerca usando il cmdlet Set-MailboxSearch per modificare il parametro AllPublicFolderSources da $true a $false.

Il parametro Language specifica l'impostazione locale per la ricerca.

L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.

Il parametro LogLevel consente di specificare un livello di registrazione per la ricerca cassetta postale. I valori validi sono:

• Basic: vengono mantenuti i dettagli di base della ricerca. Questo è il valore predefinito.
• Completo: oltre ai dettagli nel livello di registrazione Basic, è incluso un elenco completo di tutti i messaggi restituiti.
• Elimina: la registrazione viene eliminata. Non viene mantenuto alcun registro.

Il parametro MessageTypes consente di specificare i tipi di messaggio da includere nella ricerca. I valori validi sono:

• Contatti
• Docs
• Posta elettronica
• IM
• Riviste
• Riunioni
• Note
• Attività

È possibile specificare più valori separati da virgole.

Il valore predefinito è vuoto ($null), vale a dire che tutti i tipi di messaggio vengono inclusi. Per cancellare tutti i valori specificati, usare il valore $null.

Il parametro Name consente di specificare un nome per la ricerca. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Il valore di questo parametro viene usato per creare una cartella di livello superiore che trattiene i risultati della ricerca all'interno della cassetta postale di destinazione che è indicata dal parametro TargetMailbox.

Il parametro Recipients consente di specificare uno o più destinatari inclusi nella query di ricerca. Nei risultati della ricerca vengono restituiti i messaggi con i destinatari nei campi A, Cc e Ccn.

È possibile indicare più destinatari, separati da virgole. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Per cancellare i destinatari, usare il valore $null.

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro SearchDumpster specifica se viene eseguita la ricerca nel dumpster. Il dumpster è un'area di archiviazione nella cassetta postale in cui gli elementi eliminati vengono archiviati temporaneamente dopo essere stati eliminati o rimossi dalla cartella Posta eliminata o dopo essere stati eliminati definitivamente e prima di essere eliminati dalla cassetta postale in base alle impostazioni di conservazione degli elementi eliminati.

Impostare il valore su $true per abilitare la ricerca nel dumpster o impostare su $false per disabilitarlo.

Il parametro SearchQuery specifica le parole chiave della query di ricerca utilizzando Keyword Query Language (KQL). Per altre informazioni, vedere Informazioni di riferimento sulla sintassi KQL (Keyword Query Language) e Query con parole chiave e condizioni di ricerca per eDiscovery.

Se si utilizza questo parametro con altri parametri della query di ricerca, la query unisce i parametri utilizzando l'operatore AND.

Gli altri parametri della query di ricerca sono:

• EndDate
• MessageTypes
• Destinatari
• Mittenti
• StartDate

Il parametro Senders consente di specificare uno o più mittente da includere nella query di ricerca. I messaggi con mittente specificato vengono restituiti nei risultati della ricerca. I mittenti possono includere gli utenti, i gruppi di distribuzione (messaggi inviati dai membri del gruppo), gli indirizzi SMTP o i domini.

È possibile specificare più mittenti, separati da virgole. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Per cancellare i mittenti, usare il valore $null.

Il parametro SourceMailboxes consente di specificare le cassette postali da ricercare. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Per usare questo parametro, il parametro AllSourceMailboxes deve essere $false (il valore predefinito).

Per cancellare le cassette postali di origine, utilizzare il valore $null.

Per abilitare In-Place blocco sui risultati della ricerca, è necessario impostare il parametro AllSourceMailboxes su $false (il valore predefinito) e configurare una o entrambe le impostazioni seguenti:

• Specificare una o più cassette postali di origine usando il parametro SourceMailboxes.
• In Exchange locale impostare il parametro AllPublicFolderSources su $true.

Il parametro StartDate consente di specificare la data di inizio dell'intervallo di date.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Per cancellare la data di inizio, usare il valore $null.

Il parametro StatisticsStartIndex viene usato dall'interfaccia di amministrazione di Exchange per recuperare le statistiche delle parole chiave in un'operazione di paging.

Il parametro StatusMailRecipients consente di specificare uno o più destinatari che riceveranno un messaggio di posta elettronica di stato al completamento della ricerca. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

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)

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.