Test-CsGroupExpansion
Tópico modificado em: 2012-03-27
Testa a capacidade de um usuário empregar a expansão de grupos. O Microsoft Lync Server 2010 permite que os usuários configurem um grupo de distribuição do Active Directory como um contato. Quando se "expande" um grupo, serão exibidos os nomes e as informações de presença de cada membro do grupo.
Sintaxe
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Às vezes, os usuários precisam se comunicar com frequência com todos os membros de um grupo de distribuição do Active Directory. Por exemplo: o grupo pode compreender todos os membros de uma equipe ou todas as pessoas envolvidas em um determinado projeto. Sabendo-se disso, o Lync Server 2010 permite configurar um grupo de distribuição como um contato. Se você fizer isso, poderá enviar a mesma mensagem instantânea para todos os membros do grupo, bastando endereçar a mensagem para o grupo, em vez de cada um de seus membros.
Haverá ocasiões em que será necessário se comunicar com determinados indivíduos nesse grupo (ou verificar a sua presença). A expansão do grupo permite exibir de maneira fácil e rápida todos os membros do grupo e o seu repectivo status. Além disso, também é possível selecionar um ou mais membros de grupos e, em seguida, enviar uma mensagem instantânea apenas a esses usuários, em vez de todos os usuários do grupo.
A expansão de grupos é habilitada e desabilitada pelo cmdlet Set-CsWebServiceConfiguration. Se a expansão de grupo for habilitada, será possível determinar se o recurso está funcionando ou não, executando-se o cmdlet Test-CsGroupExpansion. Com esse cmdlet, é possível especificar um grupo de distribuição do Active Directory, usando o endereço de email do grupo. Test-CsGroupExpansion usa a expansão de grupos para recuperar a associação ao grupo e comparar a lista recuperada com a associação do endereço de email do grupo fornecido. Se as duas listas coincidirem, a expansão de grupo estará funcionando corretamente.
Observe que é possível testar a expansão de grupo de duas maneiras diferentes: ao testar o serviço ou ao testar o serviço web associado.
Quem pode executar esse cmdlet: 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 "Test-CsGroupExpansion"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
GroupEmailAddress |
Obrigatório |
Cadeia de caracteres |
Endereço de email do grupo de distribuição em questão. Por exemplo: -GroupEmailAddress "FinanceGroup@litwareinc.com". |
External |
Opcional |
Parâmetro de opção |
Permite verificar se os usuários externos podem usar a expansão de grupo. |
RegistrarPort |
Inteiro |
Cadeia de caracteres |
Porta SIP usada pelo serviço Registrador. Esse parâmetro não será necessário se o Registrador usar a porta padrão 5061. |
TargetFqdn |
Opcional |
Cadeia de caracteres |
O nome de domínio totalmente qualificado (FQDN) do pool de registradores no qual a expansão de grupos será testada. Por exemplo: -TargetFqdn "atl-cs-001.litwareinc.com". Observe que não é possível utilizar os parâmetros TargetUri e TargetFqdn no mesmo comando. |
TargetUri |
Opcional |
Cadeia de caracteres |
O Identificador de recurso uniforme (URI) do serviço web Expansão de grupos. Por exemplo: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Observe que não é possível utilizar os parâmetros TargetUri e TargetFqdn no mesmo comando. |
UserCredential |
Opcional |
Objeto de credencial PS |
O objeto de credencial da conta do usuário a ser utilizada no teste. O valor passado para UserCredential deve ser uma referência de objeto obtida ao se utilizar o cmdlet Get-Credential. Por exemplo, esse código retorna um objeto de credenciais para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável denominada $x: $x = Get-Credential "litwareinc\kenmyer" É necessário fornecer ao usuário uma senha ao se executar esse comando. A credencial do usuário não será necessária se você estiver executando o teste com as credenciais do usuário registrado no sistema e usando o parâmetro TargetFqdn. A credencial do usuário será obrigatória, se você estiver utilizando o parâmetro TargetUri. |
UserSipAddress |
Opcional |
Cadeia de caracteres |
Endereço SIP do usuário a ser utilizado no teste. Se esse parâmetro não for especificado, Test-CsGroupExpansion conduzirá as suas verificações utilizando a conta do usuário registrado no sistema. |
WebCredential |
Opcional |
Objeto PS Credential |
Um objeto que contém credenciais de usuário para acesso ao serviço de Informações de Local. Esse objeto pode ser recuperado chamando o cmdlet Get-Credential e fornecendo as credenciais apropriadas. Esse parâmetro será necessário se os parâmetros TargetUri e UserSipAddress forem especificados e se o computador em que estiver se executando o comando não possuir um certificado de servidor. |
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. |
OutVerboseVariable |
Opcional |
Cadeia de caracteres |
Quando presente, a saída detalhada da execução do cmdlet será armazenada na variável especificada. Por exemplo, para armazenar a saída em uma variável denominada $TestOutput, use a seguinte sintaxe: -OutVerboseVariable TestOutput Não coloque um caractere $ como prefixo ao especificar o nome da variável. |
Verbose |
Opcional |
GUID |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma. Test-CsGroupExpansion não aceita a entrada canalizada.
Tipos de Retorno
Test-CsGroupExpansion retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
O comando exibido no Exemplo 1 estabelece conexão com o pool de registradores atl-cs-001.litwareinc.com, para verificar a expansão do grupo. Para executar o teste, o comando usa o grupo FinanceGroup@litwareinc.com.