• Artigo

Set-CsRegistrarConfiguration

 

Tópico modificado em: 2012-03-26

Modifica os valores de propriedade em uma coleção existente de definições de configuração de Registrador. Os registradores são usados para autenticar solicitações de logon e para manter informações sobre o status e a disponibilidade do usuário.

Sintaxe

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

Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

É possível que o registrador seja o componente mais importante do Microsoft Lync Server 2010; afinal, sem um registrador, os usuários não poderiam fazer o logon no sistema e o Lync Server 2010 não poderia rastrear os usuários e determinar o seu status. Quando um usuário se registra no Lync Server, o ponto de extremidade no qual o usuário está se registrando envia uma solicitação REGISTER para o registrador. Por sua vez, o servidor responde verificando as credenciais de autenticação do dispositivo do cliente. Se o cliente for aprovado nessa verificação (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 (um endereço IP, uma porta e um nome de usuário) serão registradas no banco de dados de registro. Quando o usuário efetuar o logoff, estas informações serão removidas do banco de dados. Entre o logon e o logoff, o registrador mantém atualizadas as informações de status e ajuda a rotear mensagens de e para o usuário.

As definições de configuração do registrador são usadas para ajudar a gerenciar pontos de extremidade e inscrições de ponto de extremidade; essas definições podem ser aplicadas no escopo global, do site ou do serviço. (as definições associadas ao escopo de serviço somente poderão ser utilizadas com o serviço de Registrador). O cmdlet Set-CsRegistrarConfiguration pode ser utilizado para modificar quaisquer (ou todas) coleções de configuração de registrador em uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsRegistrarConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração de registrador a serem modificadas. Para modificar as definições globais, use a sintaxe a seguir: -Identity global. Para modificar as definições configuradas no escopo de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Para modificar as definições no nível de serviço, utilize uma sintaxe como esta: -Identity service:Registrar:atl-cs-001.litwareinc.com. Observe que as definições do registrador podem ser aplicadas somente ao serviço do registrador. Ocorrerá uma mensagem de erro caso se tente aplicar essas definições a qualquer outro serviço.

Instance

Opcional

Objeto RegistrarSettings

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

DefaultEndpointExpiration

Opcional

Inteiro

Quando os pontos de extremidade efetuam logon, eles têm a opção de solicitar um limite de tempo para expiração; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer registrado no sistema antes que tenha de contatar o servidor e solicitar uma prorrogação. A propriedade DefaultEndpointExpiration representa o limite de tempo de expiração para clientes que não solicitam um limite de tempo específico.

DefaultEndpointExpiration deve ter um valor entre 300 (cinco minutos) e 900 (15 minutos). O valor padrão é 600 (10 minutos).

EnableDHCPServer

Opcional

Booleano

Indica se os pontos de extremidade podem utilizar servidores DHCP para localizar um Registrador. Se True, os clientes enviarão uma mensagem Inform DHCP ao serem iniciados; o servidor DHCP responderá, enviando o nome de domínio totalmente qualificado (FQDN) de um registrador, que pode ser utilizado para efetuar o logon do usuário.

MaxEndpointExpiration

Opcional

Inteiro

Quando os pontos de extremidade efetuam logon, eles têm a opção de solicitar um limite de tempo para expiração; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer registrado no sistema antes que tenha de contatar o servidor e solicitar uma prorrogação. A propriedade MaxEndpointExpiration representa o período máximo de tempo a ser concedido aos clientes. Por exemplo, se o período máximo for definido como 600 segundos e um cliente solicitar um intervalo de ociosidade de 800 segundos, o cliente receberá o período de expiração máximo permitido. 600 segundos.

MaxEndpointExpiration deve ter um valor entre 300 (cinco minutos) e 900 (15 minutos). O valor padrão é 900.

MaxEndpointsPerUser

Opcional

Inteiro

Indica o número máximo de pontos de extremidade que podem estar simultaneamente conectados ao sistema pelo usuário. Por exemplo, um usuário que estiver registrado no Lync Server 2010 com um computador e um telefone celular estaria utilizando dois pontos de extremidade. MaxEndPointsPerUser deve ser definido com um valor entre 1 e 64, inclusive. O valor padrão é 8.

MinEndpointExpiration

Opcional

Inteiro

Quando os pontos de extremidade efetuam logon, eles têm a opção de solicitar um limite de tempo para expiração; isto especifica o intervalo de tempo que um ponto de extremidade pode permanecer registrado no sistema antes que tenha de contatar o servidor e solicitar uma prorrogação. A propriedade MinEndpointExpiration representa o período mínimo de tempo que pode ser concedido aos clientes. Por exemplo, se o período mínimo for definido como 600 segundos e um cliente solicitar um intervalo de ociosidade de 200 segundos, o cliente receberá o período de expiração mínimo permitido: 600 segundos.

MinEndpointExpiration deve ter um valor entre 300 (cinco minutos) e 900 (15 minutos). O valor padrão é 300.

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.Registrar.RegistrarSettings. Set-CsRegistrarConfiguration aceita instâncias canalizadas do objeto de definições do Registrador.

Tipos de Retorno

Set-CsRegistrarConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemplo

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

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

O comando anterior modifica as definições de configuração de registrador aplicadas ao site de Redmond (-Identity site:Redmond). Neste exemplo, o valor da propriedade EnableDHCPServer é definido como True.

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

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

No Exemplo 2, serão modificadas quaisquer definições de configuração de registrador que concederem aos usuários mais de oito pontos de extremidade. Para realizar isso, primeiramente o comando chama Get-CsRegistrarConfiguration sem nenhum parâmetro, que retorna uma coleção de todas as definições de configuração de registrador usadas na organização. Esta coleção será, então, canalizada para Where-Object, que selecionará somente as definições cuja propriedade MaxEndpointsPerUser for maior que (-gt) 8. Finalmente, a coleção filtrada será canalizada para Set-CsRegistrarCollection, que, para cada item da coleção, definirá como oito o número máximo de pontos de extremidade.

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

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

O comando exibido no Exemplo 3 desabilita o registro do cliente por meio do servidor DHCP para cada site na organização que hospeda uma coleção das definições de configuração do Registrador. Para fazer isto, o comando chama Get-CsRegistrarConfiguration, juntamente com o parâmetro -Filter. O valor do parâmetro "site" limita os dados retornados às definições que tiverem sido configuradas no escopo de site. Esta coleção será então canalizada para Set-CsRegistrarConfiguration, que utilizará o parâmetro -EnableDHCPServer e o valor de parâmetro $False para evitar que os clientes utilizem um servidor DHCP para localizar um Registrador.