Compartilhar via

  • Artigo

Set-CsHealthMonitoringConfiguration

 

Tópico modificado em: 2012-03-25

Modifica uma coleção existente de definições de configuração de monitoramento de integridade. Essas definições permitem aos administradores executar testes de garantia de qualidade sem ter de fornecer os nomes e as senhas de usuários das contas de teste em questão.

Sintaxe

Set-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

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

As transações sintéticas podem ser conduzidas de duas maneiras diferentes. Muitos administradores usarão os cmdlets CsHealthMonitoringConfiguration para definir as contas de usuários de teste de cada um dos seus pools de registradores. Essas contas de teste são um par de contas de usuários que foram configuradas anteriormente para uso com transações sintéticas (normalmente, essas são contas de teste, e não pertencem a usuários reais). Quando as contas de teste são configuradas para um pool, os administradores podem executar uma transação sintética nesse pool, sem ter de especificar as identidades (nem fornecer credenciais) das contas dos usuários envolvidos no teste. Em vez disso, a transação sintética utilizará automaticamente as contas de teste pré-configuradas ao realizar as suas verificações.

Como alternativa, os administradores podem executar uma transação sintética utilizando contas de usuários reais. Por exemplo, se dois usuários não puderem trocar mensagens instantâneas, um administrador poderia executar uma transação sintética usando as duas contas dos usuários em questão (em vez de um par de contas de teste). Se decidir conduzir uma transação sintética usando contas de usuários reais, você terá de fornecer as credenciais para cada usuário.

Depois que se tiver configurado as definições de configuração de monitoramento de integridade, será possível modificar essas definições a qualquer momento, utilizando-se o cmdlet Set-CsHealthMonitoringConfiguration. Este cmdlet permite alterar uma ou ambas as contas de teste configuradas para uso com o pool.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsHealthMonitoringConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

FQDN

Nome de domínio totalmente qualificado (FQDN) do pool no qual tiverem sido atribuídas as definições de configuração de monitoramento de integridade a serem modificadas. Por exemplo: -Identity atl-cs-001.litwareinc.com.

Instance

Opcional

Objeto HealthMonitoringSettings

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

FirstTestSamAccountName

Opcional

Cadeia de caracteres

SamAccountName do primeiro usuário de teste. FirstTestSamAccountName deve ser inserido usando-se o formato domínio\nome de usuário. Por exemplo:

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Opcional

Endereço SIP

Endereço SIP do primeiro usuário de teste a ser configurado para uso por esta coleção de definições de monitoramento de integridade. Observe que o endereço SIP deve incluir o prefixo: sip:. Por exemplo: -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Opcional

Cadeia de caracteres

SamAccountName do segundo usuário de teste. SecondTestSamAccountName deve ser inserido usando-se o formato domínio\nome de usuário. Por exemplo:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Opcional

Endereço SIP

Endereço SIP do segundo usuário de teste a ser configurado para uso por esta coleção de definições de monitoramento de integridade. Observe que o endereço SIP deve incluir o prefixo sip:. Por exemplo: -FirstTestUserSipUri "sip:pilar@litwareinc.com".

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a 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. Set-CsHealthMonitoringConfiguration aceita instâncias canalizadas do objeto de configuração de monitoramento de integridade.

Tipos de Retorno

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

Exemplo

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

Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

O comando apresentado no Exemplo 1 configura o primeiro usuário de teste atribuído às definições de configuração de monitoramento de integridade do pool atl-cs-001.litwareinc.com. Neste exemplo, o endereço SIP do novo usuário de teste é definido como sip:kenmyer@litwareinc.com e o SamAccountName deste usuário de teste é definido como kenmyer.

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

Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

O comando anterior é uma variação do comando apresentado no Exemplo 1. Neste caso, entretanto, o mesmo usuário de teste é atribuído a cada coleção de definições de configuração de monitoramento de integridade em uso na organização. Para realizar esta tarefa, o comando utiliza primeiramente Get-CsHealthMonitoringConfiguration, para retornar uma coleção de todas as definições de configuração de monitoramento de integridade. Esta coleção será então canalizada para Set-CsHealthMonitoringConfiguration, que atribuirá o mesmo endereço SIP do primeiro usuário de teste e SamAccountName a cada item na coleção.

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

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

O Exemplo 3 mostra como é possível pesquisar e substituir o primeiro usuário de teste atribuído a uma coleção de definições de configuração de integridade. Neste exemplo, o usuário com o endereço SIP sip:pilar@litwareinc.com será substituído sempre que aparecer como primeiro usuário de teste na coleção.

Para fazer isso, o comando chama primeiramente Get-CsHealthMonitoringConfiguration, sem qualquer parâmetro adicional, retornando uma coleção de todas as definições de configuração de monitoramento de integridade em uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará somente os itens cuja propriedade FirstTestUserSipUri for igual a (-eq) sip:pilar@litwareinc.com. Esta coleção filtrada será, por sua vez, canalizada para Set-CsHealthMonitoringConfiguration, que tratará cada item na coleção, definindo o valor da propriedade FirstTestUserSipUri como sip:kenmyer@litwareinc.com e o valor da propriedade FirstTestSamAccountName como kenmyer.