Test-AssistantHealth

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Test-AssistantHealth para comprobar que el servicio Microsoft Exchange Mailbox Assistants (MSExchangeMailboxAssistants) está en buen estado, para recuperarse de problemas de mantenimiento e informar del estado de la acción de diagnóstico o recuperación.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Test-AssistantHealth
    [[-ServerName] <ServerIdParameter>]
    [-Confirm]
    [-IncludeCrashDump]
    [-MaxProcessingTimeInMinutes <UInt32>]
    [-MonitoringContext]
    [-ResolveProblems]
    [-WatermarkBehindWarningThreholdInMinutes <UInt32>]
    [-WhatIf]
    [<CommonParameters>]

Description

El servicio de asistentes de buzones se ejecuta en todos los servidores en los que se ha instalado el rol de servidor Buzón de correo. Este servicio se encarga de programar y distribuir distintos asistentes que garantizan que los buzones funcionen correctamente.

De forma predeterminada, cuando se ejecuta este cmdlet, devuelve RunspaceId, eventos y contadores de rendimiento en forma de tabla.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Test-AssistantHealth -ServerName MBXSVR01 -IncludeCrashDump -ResolveProblems | Format-List

En este ejemplo se detecta y se repara el estado del asistente de buzones de correo en MBXSVR01. Se incluye información sobre los errores y los resultados se muestran en una lista.

Ejemplo 2

Test-AssistantHealth -MaxProcessingTimeInMinutes 30 | Format-List

En este ejemplo se establece el estado del asistente de buzón en el servidor de buzón local. El parámetro MaxProcessingTimeInMinutes especifica 30 minutos como el tiempo máximo de que dispone el servicio para procesar un evento sin responder, y los resultados se muestran en una lista.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
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

-IncludeCrashDump

El modificador IncludeCrashDump especifica que el comando debe tomar un informe de errores antes de realizar las acciones de recuperación. No es necesario especificar un valor con este modificador.

Solo debe usar este conmutador en el equipo local. Si usa este conmutador mientras está conectado de forma remota, se producirá un error en el comando.

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

-MaxProcessingTimeInMinutes

El parámetro MaxProcessingTimeInMinutes especifica el tiempo máximo de que dispone el servicio MSExchangeMailboxAssistants para procesar un evento sin responder. Puede especificar un valor comprendido entre 1 y 3600 minutos. El valor predeterminado es de 15 minutos.

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

-MonitoringContext

El conmutador MonitoringContext incluye o excluye los eventos de supervisión y contadores de rendimiento asociados en los resultados. No es necesario especificar un valor con este modificador.

Normalmente, se incluyen los eventos de supervisión y los contadores de rendimiento en los resultados cuando la salida se pasa 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

-ResolveProblems

Este modificador ResolveProblems especifica que, si el comando detecta un problema, intenta corregirlo. No es necesario especificar un valor con este modificador.

Este comando intenta solucionar los problemas siguientes:

  • Si no está en ejecución, se inicia el servicio asistentes de buzón.
  • Reinicia el servicio de asistentes de buzón si detecta que el servicio permanece sin respuesta o interbloqueado durante más de 15 minutos.
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

-ServerName

El parámetro ServerName especifica el servidor de buzones donde desea ejecutar este comando. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Name
  • FQDN
  • Distinguished name (DN)
  • Nombre distintivo (DN) heredado de Exchange

Nombre distintivo (DN) heredado de Exchange

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

-WatermarkBehindWarningThreholdInMinutes

El parámetro WatermarkBehindWarningThreholdInMinutes especifica el umbral de antigüedad de la marca de agua. Las marcas de agua de eventos indican la última vez que un asistente procesó los eventos correctamente. Cuando una marca de agua no se ha actualizado durante un tiempo, puede indicar que existe un problema. En los asistentes de buzones de correo, el cmdlet Test-AssistantHealth compara la hora actual con la marca de tiempo de la última marca de agua del evento para determinar la antigüedad de la marca de agua. Si dicha antigüedad supera el valor establecido en el parámetro WatermarkBehindWarningThreholdInMinutes, se genera una advertencia.

Puede especificar un valor comprendido entre 1 y 10.080 minutos. El valor predeterminado es de 60 minutos.

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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.