Test-ExchangeSearch
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Test-ExchangeSearch per verificare che Ricerca di Exchange sia attualmente abilitato e indicizzare i nuovi messaggi di posta elettronica in modo tempestivo.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Test-ExchangeSearch
[[-Identity] <MailboxIdParameter>]
[-Archive]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>] Test-ExchangeSearch
[-MailboxDatabase <DatabaseIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>] Test-ExchangeSearch
[-Server <ServerIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-IndexingTimeoutInSeconds <Int32>]
[-MonitoringContext]
[-WhatIf]
[<CommonParameters>] Descrizione
Il cmdlet Test-ExchangeSearch crea un messaggio nascosto e un allegato nella cassetta postale specificata visibile solo a Ricerca di Exchange. Il comando attende l'indicizzazione del messaggio e quindi esegue la ricerca del contenuto. Una volta trascorso l'intervallo impostato nel parametro IndexingTimeoutInSeconds, viene segnalato l'esito positivo o negativo a seconda che il messaggio sia stato trovato o meno.
È possibile utilizzare l'opzione Verbose per ottenere informazioni dettagliate su ogni passaggio eseguito dal cmdlet come parte del test.
È 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
Test-ExchangeSearch -Identity john@contoso.comIn questo esempio vengono testati i risultati di Ricerca di Exchange per il database delle cassette postali in cui risiede la cassetta postale specificata.
Esempio 2
Test-ExchangeSearch -Identity john@contoso.com -VerboseIn questo esempio vengono testati i risultati di Ricerca di Exchange per il database delle cassette postali in cui risiede la cassetta postale specificata. L'opzione Verbose viene utilizzata per visualizzare informazioni dettagliate.
Parametri
-Archive
L'opzione Archive specifica che il test viene eseguito sulla cassetta postale di archiviazione per l'utente della cassetta postale specificato dal parametro Identity. 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 |
-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 |
-DomainController
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 consente di specificare la cassetta postale su cui si vuole testare Ricerca di Exchange. È 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)
Non è possibile usare questo parametro con i parametri MailboxDatabase o Server.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IndexingTimeoutInSeconds
Il parametro IndexingTimeoutInSeconds consente di specificare la quantità massima di tempo di attesa, in secondi, tra l'aggiunta del nuovo messaggio di posta elettronica alla cassetta postale di test e la restituzione del messaggio in un risultato della ricerca. Il valore predefinito è 120 secondi. Se questo parametro non è specificato, viene utilizzato l'intervallo predefinito.
| Type: | Int32 |
| 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 |
-MailboxDatabase
Questo parametro funziona solo in Exchange Server 2010 e 2013.
Il parametro MailboxDatabase consente di specificare il database delle cassette postali su cui eseguire il test di Ricerca di Exchange. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Non è possibile usare questo parametro con i parametri Identity o Server.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MonitoringContext
L'opzione MonitoringContext include nei risultati gli eventi di monitoraggio e i contatori delle prestazioni associati. Con questa opzione non è necessario specificare alcun valore.
In genere, si includono gli eventi di monitoraggio e i contatori delle prestazioni nei risultati quando l'output viene passato a Microsoft System Center Operations Manager (SCOM).
| 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 |
-Server
Il parametro Server consente di specificare il server Exchange per il destinatario su cui si vuole testare Ricerca di Exchange. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- DN legacy di Exchange
Non è possibile usare questo parametro con i parametri MailboxDatabase o Identity.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
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.