Condividi tramite

Test-ExchangeSearch

Modulo:
Exchange PowerShell

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

Identity 

Test-ExchangeSearch
    [[-Identity] <MailboxIdParameter>]
    [-Archive]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IndexingTimeoutInSeconds <Int32>]
    [-MonitoringContext]
    [-WhatIf]
    [<CommonParameters>]

Database 

Test-ExchangeSearch
    [-MailboxDatabase <DatabaseIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IndexingTimeoutInSeconds <Int32>]
    [-MonitoringContext]
    [-WhatIf]
    [<CommonParameters>]

Server 

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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.com

In 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 -Verbose

In 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

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

L'opzione Archivio 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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\Nome utente
  • 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.

Proprietà dei parametri

Tipo:MailboxIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IndexingTimeoutInSeconds

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MailboxDatabase

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:DatabaseIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Database
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-MonitoringContext

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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).

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Server

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:ServerIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Server
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.