Test-AssistantHealth
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Test-AssistantHealth para verificar se o serviço Assistentes de Caixa de Correio do Microsoft Exchange (MSExchangeMailboxAssistants) está íntegro, para se recuperar de problemas de integridade e para relatar o status da ação de diagnóstico ou recuperação.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Test-AssistantHealth
[[-ServerName] <ServerIdParameter>]
[-Confirm]
[-IncludeCrashDump]
[-MaxProcessingTimeInMinutes <UInt32>]
[-MonitoringContext]
[-ResolveProblems]
[-WatermarkBehindWarningThreholdInMinutes <UInt32>]
[-WhatIf]
[<CommonParameters>]
Description
O serviço de Assistentes de Caixa de Correio é executado em todos os servidores que possuem a função de servidor de Caixa de Correio instalada. Esse serviço é responsável por programar e distribuir diversos assistentes que garantem que as caixas de correio funcionem corretamente.
Por padrão, quando esse cmdlet é executado, ele retorna o RunspaceId, eventos e contadores de desempenho no formato de uma tabela.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Test-AssistantHealth -ServerName MBXSVR01 -IncludeCrashDump -ResolveProblems | Format-List
Esse exemplo detecta e repara a integridade do assistente de caixa de correio no MBXSVR01, inclui as informações de erro e formata a saída para uma lista.
Exemplo 2
Test-AssistantHealth -MaxProcessingTimeInMinutes 30 | Format-List
Esse exemplo detecta a integridade do assistente da caixa de correio no servidor da Caixa de Correio local. O parâmetro MaxProcessingTimeInMinutes especifica 30 minutos como a duração máxima que o serviço pode processar um evento sem responder e formatar o resultado em uma lista.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeCrashDump
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção IncludeCrashDump especifica que o comando deve obter um relatório de erro antes de executar qualquer ação de recuperação. Não é preciso especificar um valor com essa opção.
Você só deve usar essa opção no computador local. Se você usar essa opção enquanto estiver conectado remotamente, o comando falhará.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaxProcessingTimeInMinutes
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro MaxProcessingTimeInMinutes especifica a duração máxima que o serviço MSExchangeMailboxAssistants pode processar um evento sem responder. É possível especificar um valor de 1 a 3600 minutos. O valor padrão é 15 minutos.
Propriedades do parâmetro
| Tipo: | UInt32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MonitoringContext
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção MonitoringContext inclui os eventos de monitoramento e os contadores de desempenho associados nos resultados. Não é preciso especificar um valor com essa opção.
Normalmente, você inclui os eventos de monitoramento e os contadores de desempenho nos resultados quando a saída é passada para o Microsoft System Center Operations Manager (SCOM).
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResolveProblems
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Essa opção ResolveProblems especifica que, se o comando detectar um problema, ele tentará corrigi-lo. Não é preciso especificar um valor com essa opção.
O comando tenta corrigir os seguintes problemas:
- Inicia o serviço de Assistentes de Caixa de Correio se ele não estiver sendo executado.
- Reinicia o serviço de Assistentes de Caixa de Correio se ele detectar que o serviço está suspenso ou bloqueado por mais de 15 minutos.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ServerName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ServerName especifica o servidor de Caixa de Correio no qual você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
DN Herdado do Exchange
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WatermarkBehindWarningThreholdInMinutes
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro WatermarkBehindWarningThreholdInMinutes especifica o limite de idade de marca d'água. As marcas d'água de evento indicam o horário mais recente em que os eventos foram processados com êxito por um assistente. Uma marca d'água de evento que não é atualizada há algum tempo pode indicar um problema. Para cada Assistente de Caixa de Correio, o cmdlet Test-AssistantHealth compara o horário atual com o carimbo de data/hora da marca d'água de evento mais recente para determinar a idade da marca d'água. Se a idade exceder o valor definido pelo parâmetro WatermarkBehindWarningThreholdInMinutes, um aviso será gerado.
É possível especificar um valor de 1 a 10080 minutos. O valor padrão é 60 minutos.
Propriedades do parâmetro
| Tipo: | UInt32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.