• Artigo

Get-CsRegistrarConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração do Registrador atualmente em uso na organização. Os Registradores são usados para autenticar solicitações de logon e manter informações sobre disponibilidade e status de usuário.

Sintaxe

Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

O Registrador talvez seja o componente mais importante do Microsoft Lync Server 2010; afinal, sem um Registrador, os usuários não poderiam fazer logon no sistema e o Lync Server 2010 não poderia controlar os usuários e o status atual. Quando um usuário faz logon no Lync Server, o ponto de extremidade do qual o usuário está fazendo logon envia uma solicitação REGISTER ao Registrador; em seguida, o servidor responde desafiando o dispositivo cliente solicitando credenciais de autenticação. Se o cliente for aprovado no desafio (ou seja, se o cliente apresentar um conjunto válido de credenciais), o usuário será autenticado e as informações do ponto de extremidade, como endereço IP, porta e nome do usuário, serão registradas no banco de dados do registro. Quando um usuário faz logoff, essas informações são removidas do banco de dados. Entre logon e logoff, o Registrador mantem informações de status atualizadas e ajuda a encaminhar mensagens para e do usuário.

As configurações de Registrador são usadas para ajudar a gerenciar pontos de extremidade e inscrições de ponto de extremidade; essas configurações podem ser aplicadas no escopo global, do site ou do serviço. (As configurações de escopo do serviço só podem ser usados com o serviço Registrador.) O cmdlet Get-CsRegistrarConfiguration é usado para retornar informações sobre todas as coleções de configurações do Registrador em uso na organização.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsRegistrarConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsRegistrarConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo das definições de configuração do Registrador a serem retornadas. Para retornar as configurações globais, use esta sintaxe: -Identity global. Para retornar definições configuradas no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para retornar configurações no nível de serviço, use uma sintaxe como esta: -Identity service:Registrar:atl-cs-001.litwareinc.com.

Se esse parâmetro for omitido, Get-CsRegistrarConfiguration retornará todas as definições de configuração do Registrador em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite usar curingas para retornar uma ou mais coleções das definições de configuração do Registrador. Por exemplo, para retornar todas as definições configuradas no escopo do site, use esta sintaxe: -Filter "site:*". Para retornar todas as definições configuradas no escopo do serviço, use esta sintaxe: -Filter "service:*".

LocalStore

Opcional

Parâmetros de opção

Obtém as definições de configuração do Registrador a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsRegistrarConfiguration não aceita entrada em pipeline.

Tipos de Retorno

Get-CsRegistrarConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemplo

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

Get-CsRegistrarConfiguration

O comando mostrado no Exemplo 1 retorna uma coleção de todas as definições de configuração do Registrador em uso na organização.

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

Get-CsRegistrarConfiguration -Identity site:Redmond

O Exemplo 2 retorna uma única coleção de definições de configuração do Registrador: as definições configuradas para o site de Redmond (-Identity site:Redmond).

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

Get-CsRegistrarConfiguration -Filter "service:*"

No Exemplo 3, são retornadas informações sobre todas as definições de configuração do Registrador atribuídas no escopo do serviço. Para isso, o comando usa o parâmetro Filter e o valor de filtro "service:*"; esse valor de filtro garante que apenas as configurações com uma Identity que comece com o valor da cadeia de caracteres "service:" sejam retornadas.

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

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}

O Exemplo 4 retorna informações sobre as definições de configuração do Registrador que permitam o uso de servidores DHCP para registrar clientes. Para realizar essa tarefa, o comando chama inicialmente Get-CsRegistrarConfiguration sem nenhum parâmetro; isso retorna uma coleção de todas as definições de configuração do Registrador atualmente em uso. Esta coleção é então direcionada para Where-Object, que seleciona somente as configurações nas quais a propriedade EnableDHCPServer seja igual a True.

-------------------------- Exemplo 5 --------------------------

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8}

No comando anterior, a informação é retornada para todas as definições de configuração do Registrador que permitem mais de oito pontos de extremidade por usuário. Para obter isso, o comando primeiro usa o Get-CsRegistrarConfiguration para retornar um conjunto de todas as configurações do Registrado usadas na organização. Este conjunto é canalizado para o cmdlet Where-Object, que escolhe as configurações onde a propriedade MaxEndpointsPerUser é maior que 8.