Compartilhar via

  • Artigo

Remove-CsHealthMonitoringConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma coleção existente configurações de monitoramento de integridade. Estas configurações habilitam administradores a executar testes de garantia de qualidade sem ter que fornecer ao usuário nomes e senhas das contas de teste necessárias.

Sintaxe

Remove-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As transações sintéticas são usadas no Microsoft Lync Server 2010 para verificar se os usuários podem concluir tarefas comuns, como fazer logon no sistema, trocar mensagens instantâneas ou fazer chamadas para um telefone localizado na PSTN (rede telefônica pública comutada). Esses testes podem ser conduzidos manualmente por um administrador, ou ser executados automaticamente por um aplicativo como o Microsoft System Center Operations Manager (anteriormente Microsoft Operations Manager).

Transações sintéticas podem ser conduzidas de duas formas diferentes. Muitos administradores vão usar os cmdlets CsHealthMonitoringConfiguration para configurar contas de teste para cada um de seus pools de Registrador. Essas contas de teste são um par de contas de usuários pré-configuradas para uso com transações sintéticas (geralmente, são contas de testes, e não contas que pertençam a usuários reais). Quando essas contas de teste são configuradas para um pool, os administradores podem executar uma transação sintética contra este pool, sem ter que especificar as identidades das (e fornecer as credenciais para) contas de usuário envolvidas no teste. Ao invés disso, a transação sintética vai automaticamente usar as contas de teste pré-configuradas quando executando suas verificações.

De forma alternativa, administradores podem executar uma transação sintética usando contas de usuários de verdade. Por exemplo, se dois usuários não conseguem trocar mensagens instantâneas, um administrador pode executar transações sintéticas usando as duas contas de usuário em questão (ao invés de duas contas de teste). Se optar por conduzir uma transação sintética usando contas de usuário reais, será necessário fornecer as credenciais de cada usuário.

O cmdlet Remove-CsHealthMonitoringConfiguration oferece uma forma de você remover qualquer configuração de monitoramento de integridade que tenha sido definida para uso na sua organização.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsHealthMonitoringConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHealthMonitoringConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

FQDN (nome de domínio totalmente qualificado) do pool hospedando as configurações de monitoramento de integridade a serem excluídas. Por exemplo: -Identity atl-cs-001.litwareinc.com.

Force

Opcional

Parâmetro de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings. Remove-CsHealthMonitoringConfiguration aceita instâncias em pipeline do objeto de configuração de monitoramento de integridade.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsHealthMonitoringConfiguration exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Exemplo

-------------------------- Exemplo 1 ------------------------

Remove-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com

O comando mostrado no Exemplo 1 exclui a coleção de configurações de monitoramento de integridade com a Identity atl-cs-001.litwareinc.com. Porque identidades têm que ser únicas, este comando vai excluir, no máximo, uma única coleção de configurações.

-------------------------- Exemplo 2 ------------------------

Get-CsHealthMonitoringConfiguration | Remove-CsHealthMonitoringConfiguration

Exemplo 2 exclui todas as configurações de monitoramento de integridade atualmente em uso. Para fazer isso, o comando chama primeiro Get-CsHealthMonitoringConfiguration sem nenhum parâmetro; isso retorna uma coleção de todas as configurações de monitoramento de integridade na organização. Esta coleção filtrada é então passada a Remove-CsHealthMonitoringConfiguration, que exclui cada item na coleção.

-------------------------- Exemplo 3 ------------------------

Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com  | Remove-CsHealthMonitoringConfiguration

O comando anterior exclui todas as configurações de monitoramento de integridade criadas para o domínio litwareinc.com. Para fazer isto, Get-CsHealthMonitoringConfiguration é chamado junto com o parâmetro Filter; o valor de filtro "*.litwareinc.com" garante que somente as configurações com Identidade terminando com a cadeia de caracteres ".litwareinc.com" sejam retornadas. A coleção filtrada é então encaminhada a Remove-CsHealthMonitoringConfiguration, que exclui cada item na coleção.

-------------------------- Exemplo 4 ------------------------

(Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}) | Remove-CsHealthMonitoringConfiguration

O comando mostrado no Exemplo 4 exclui todas as configurações de monitoramento de integridade que incluem o usuário com endereço SIP sip:kenmyer@litwareinc.com com um dos usuários de teste. Para executar esta tarefa, o comando começa chamando Get-CsHealthMonitoringConfiguration sem parâmetros; isso retorna uma coleção de todas as configurações de monitoramento de integridade atualmente em uso na organização. Em seguida, a coleção é encaminhada para o cmdlet Where-Object, que seleciona apenas as configurações nas quais a propriedade FirstTestUserSipUri seja igual a "sip:kenmyer@litwareinc.com" ou SecondTestUserSipUri seja igual a "sip:kenmyer@litwareinc.com". Estas configurações são encaminhadas para (e removidas por) Remove-CsHealthMonitoringConfiguration.