Compartilhar via


New-CsRegistrarConfiguration

 

Tópico modificado em: 2012-03-25

Cria uma nova coleção configurações de Registrador. Os Registradores são usados para autenticar solicitações de logon e manter informações sobre disponibilidade e status de usuário.

Sintaxe

New-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Registrador talvez seja o componente mais importante do Lync Server; afinal, sem um Registrador, os usuários não poderiam fazer logon no sistema e o Lync Server 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 passa o desafio (isto é, se o cliente apresenta um conjunto válido de credenciais), então o usuário é autenticado e informações de ponto de extremidade como endereço IP, porta e nome do usuário são registradas no banco de dados de registro. Quando o usuário se desconecta, estas informações são entã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. (Configurações no escopo do serviço podem ser usadas somente com serviço de Registrador).

O cmdlet New-CsRegistrarConfiguration habilita você a criar novas configurações de Registrador no escopo do site ou do serviço. Observe que um dado site ou serviço pode ter no máximo uma coleção de configurações; se você tentar adicionar uma coleção a um site ou serviço que já hospeda uma configuração de Registrador, seu comando irá falhar. Seu comando vai falhar também se você tentar criar novas configurações no escopo global.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo para as configurações do Registrador a serem criadas. Para criar configurações definidas no escopo do site, use a sintaxe similar a esta: -Identity site:Redmond. Para criar configurações ao nível do serviço, use sintaxe assim: -Identity service:Registrar:atl-cs-001.litwareinc.com. Note que um dado site ou serviço pode ter no máximo uma única coleção de configurações de Registrador. Se você tentar criar uma nova coleção com a Identidade site:Redmond e o site Redmond já hospedar uma coleção de configurações de Registrador, então seu comando vai falhar.

Além disso, não é possível criar novas configurações de Registrador no escopo global. Se quiser alterar valores no escopo global, use o cmdlet Set-CsRegistrarConfiguration.

DefaultEndpointExpiration

Opcional

Número inteiro

Quando pontos de extremidades se conectam eles têm a opção de pedir uma expiração do tempo de espera; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer conectado ao sistema antes que ele tenha que contatar o servidor e pedir uma extensão. A propriedade DefaultEndpointExpiration representa o intervalo da expiração do tempo de espera para clientes que não pediram um valor específico de tempo de espera.

O DefaultEndpointExpiration deve ser entre 300 (5 minutos) e 900 (15 minutos). O valor padrão é 600 (10 minutos).

EnableDHCPServer

Opcional

Booleano

Indica se pontos de extremidade podem usar servidores de DHCP para localizar um Registrador. Se for True, os clientes vão enviar uma mensagem DHCP Inform quando começarem; o servidor DHCP vai responder enviando o FQDN (nome de domínio totalmente qualificado) nome de domínio de um Registrador completamente qualificado que pode ser usado para conectar o usuário.

MaxEndpointExpiration

Opcional

Número inteiro

Quando pontos de extremidades fazem logon, eles têm a opção de solicitar uma expiração de tempo limite; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer conectado ao sistema antes que ele tenha que contatar o servidor e pedir uma extensão. A propriedade MaxEndpointExpiration representa uma quantidade máxima de tempo que clientes podem ser concedidos. Por exemplo, se o tempo máximo é definido para 600 segundos e o cliente solicita um intervalo de tempo de espera de 800 segundos, o cliente vai ser dado o período máximo de expiração permitido: 600 segundos.

O MaxEndpointExpiration deve ser entre 300 (5 minutos) e 900 (15 minutos). O valor padrão é 900.

MinEndpointExpiration

Opcional

Número inteiro

Quando pontos de extremidades fazem logon, eles têm a opção de solicitar uma expiração de tempo limite; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer conectado ao sistema antes que ele tenha que contatar o servidor e pedir uma extensão. A propriedade MinEndpointExpiration representa uma quantidade mínima de tempo que clientes podem ser concedidos. Por exemplo, se o tempo mínimo é definido para 600 segundos e o cliente solicita um intervalo de tempo de espera de 200 segundos, o cliente vai ser dado o período mínimo de expiração permitido: 600 segundos.

O MinEndpointExpiration deve ser entre 300 (5 minutos) e 900 (15 minutos). O valor padrão é 300.

MaxEndpointsPerUser

Opcional

Número inteiro

Indica o número máximo de pontos de extremidade que um usuário pode ter conectado simultaneamente ao sistema. (por exemplo, um usuário que esteja conectado ao Lync Server 2010 com um computador e um telefone celular estaria usando dois pontos de extremidade). MaxEndpointsPerUser deve ser definido com um valor entre 1 e 64, inclusive. O valor padrão é 8.

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.

InMemory

Opcional

Parâmetro de Opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

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

Tipos de Retorno

New-CsRegistrarConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemplo

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

New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True

O comando anterior cria uma nova coleção de configurações de Registrador para o site Redmond (-Identity site:Redmond). Além de especificar a Identity para as novas configurações, o comando também define o máximo de pontos de extremidade por usuário como 4 (-MaxEndpointsPerUser 4) e habilita o uso do servidor DHCP para registro de cliente (-EnableDHCPServer $True). Observe que este comando irá falhar se o site Redmond já tiver sido atribuído a uma coleção de configurações de Registrador.

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

$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory 
$x.MaxEndpointsPerUser = 4 
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x

Os comandos mostrados no Exemplo 2 também criam uma nova coleção de configurações de Registrador para o site Redmond (-Identity site:Redmond). Neste exemplo, no entanto, as configurações são inicialmente criadas em memória apenas e são aplicadas ao site em si mais tarde.

Para executar esta tarefa, o primeiro comando usa New-CsRegistrarConfiguration para criar uma nova coleção de configurações para site:Redmond; o parâmetro InMemory é acrescentado ao final do comando para garantir que estas configurações sejam criadas somente em memória e não sejam aplicadas imediatamente ao site Redmond. Como essas configurações só existem na memória, elas precisam ser armazenadas em uma variável; no exemplo, a variável chamada $x.

Nos comandos 2 e 3, duas propriedades destas novas configurações virtuais (MaxEndpointsPerUser e EnableDHCPServer) são modificadas. O comando final no exemplo usa então Set-CsRegistrarConfiguration para transformar as configurações virtuais armazenadas em $x em um conjunto verdadeiro de configurações de Registrador aplicado ao site Redmond. Se você não chamar Set-CsRegistrarConfiguration, nenhuma nova configuração vai ser criada para o site Redmond, e as suas configurações virtuais vão desaparecer assim que você encerrar sua sessão do Windows PowerShell ou excluir a variável $x.