Set-CsRegistrar
Tópico modificado em: 2012-03-26
Permite modificar as propriedades de um ou vários registradores. 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-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
É possível que o registrador seja o componente mais importante do Microsoft Lync Server 2010; 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 faz o logon no Lync Server, o ponto de extremidade no qual o usuário fizer o logon (seja um computador, um telefone celular ou algum outro dispositivo) envia uma solicitação REGISTRADOR para o servidor de registros. O servidor, por sua vez, responde verificando as credenciais de autenticação do dispositivo 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 um usuário fizer o logoff, essas 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.
O cmdlet Set-CsRegistrar permite modificar as propriedades de um ou vários registradores da organização. Essas modificações incluem a alteração de definições da porta, bem como a especificação da ação que deve ser tomada se um registrador tiver de ficar indisponível.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsRegistrar 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-CsRegistrar\b"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade de Xds |
O local do serviço do Registrador a ser modificado. Por exemplo: -Identity "Registrar:atl-cs-001.litwareinc.com". Observe que você pode omitir o prefixo "Registrar:" ao especificar um registrador. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Opcional |
Cadeia de caracteres |
O local do serviço do Servidor de Arquivamento a ser associado ao registrador. Por exemplo: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
BackupRegistrar |
Opcional |
Cadeia de caracteres |
Local de serviço do Registrador a ser usado se esse Registrador não estiver disponível. Por exemplo: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com". |
EdgeServer |
Opcional |
Cadeia de caracteres |
O local do serviço do Servidor de Borda a ser associado ao registrador. Por exemplo: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
EnableAutomaticFailover |
Opcional |
Booleano |
Se for True, o Registrador de Backup será empregado sempre que o Registrador principal estiver indisponível. Se for False, o Registrador de backup não será empregado se o Registrador primário não estiver disponível. Esse parâmetro também afeta os usuários que tiverem sido registrados com um Registrador de backup. Se esse parâmetro for definido como True, esses usuários serão descartados do Registrador de backup e registrados novamente no Registrador primário, se e quando ele se tornar disponível. |
FailbackDetectionInterval |
Opcional |
TimeSpan |
Especifica o tempo que o sistema esperará até verificar se o registrador que havia se tornado indisponível está agora disponível. Se EnableAutomaticFailover for definido como True, o sistema emitirá um failover para o registrador de backup sempre que um registrador se tornar indisponível. Isso simplesmente significa que o sistema reunirá os usuários que tiverem feito o logon no registrador com falha e tentará efetuar o seu logon no registrador de backup. A propriedade FailbackDetectionInterval especifica o tempo que o sistema irá esperar até verificar se o registrador original está disponível novamente. Se estiver, o Lync Server tentará emitir "transferência em caso de falha" para esse registrador. A transferência em caso de falha significa retornar para o registrador inicialmente em uso. Em outras palavras, efetuar o logon dos usuários no registrador original. Observe que a transferência em caso de falha é apenas um processo automatizado. Não é possível fazer a transferência manual em caso de falha de um registrador para outro. O intervalo de detecção pode ser definido para qualquer valor entre 30 segundos e 84.400 segundos (24 horas). Especifique o intervalo de tempo, usando o formato horas:minutos:segundos. Por exemplo, o seguinte formato define o intervalo como sendo 1 hora e 15 minutos: - FailbackDetectionInterval 01:15:00. Esse parâmetro não pode ser usado, a menos que você tenha especificado um registrador de backup. |
FailureDetectionInterval |
Opcional |
TimeSpan |
Especifica o intervalo de tempo que o sistema esperará antes de decidir se um Registrador está indisponível. Se EnableAutomaticFailover for definido como True, o sistema tentará efetuar o logon dos usuários no registrador de backup, em vez disso. O intervalo de detecção pode ser definido para qualquer valor entre 30 segundos e 84.400 segundos (24 horas). Especifique o intervalo de tempo, usando o formato horas:minutos:segundos. Por exemplo, o seguinte formato define o intervalo como sendo 1 hora e 15 minutos: - FailureDetectionInterval 01:15:00. Esse parâmetro não pode ser usado, a menos que você tenha especificado um registrador de backup. |
MonitoringServer |
Opcional |
Cadeia de caracteres |
O local do serviço do Servidor de Monitoramento a ser associado ao registrador. Por exemplo: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
Registrar |
Opcional |
Cadeia de caracteres |
Local de serviço do Registrador. |
SipPort |
Opcional |
Inteiro |
Porta usada para o tráfego de SIP (Protocolo de Iniciação de Sessão). |
SipHealthPort |
Opcional |
Cadeia de caracteres |
Porta usada para o monitoramento da integridade do servidor. |
SipServerTcpPort |
Opcional |
Cadeia de caracteres |
Porta de escuta SIP. O valor padrão é 5060. |
UserServer |
Opcional |
Cadeia de caracteres |
O local do serviço do servidor do Serviços de Usuário a ser associado ao registrador. Por exemplo: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
WebPort |
Opcional |
Inteiro |
Porta usada para a comunicação com os Servidores da Web. |
WebServer |
Opcional |
Cadeia de caracteres |
O local de serviço do Servidor da Web a ser associado ao Registrador. Por exemplo: -WebServer "WebServer:atl-cs-001.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
Nenhuma. Set-CsRegistrar não aceita a entrada canalizada.
Tipos de Retorno
Set-CsRegistrar não retorna qualquer objeto ou valor. Em vez disso, o comando modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayRegistrar.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
O comando exibido no Exemplo 1 define como 5072 a porta SIP do Registrador Registrar:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
O comando anterior define como 5072 a porta SIP de todos os registradores na organização. Para fazê-lo, o comando primeiramente usa Get-CsService e o parâmetro Registrar, para retornar uma coleção de todos os registradores em uso. Essa coleção será então canalizada para o cmdlet ForEach-Object, que utilizará cada registrador na coleção e executará o cmdlet Set-CsRegistrar, para alterar a porta SIP para 5072.
-------------------------- Exemplo 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
O Exemplo 3 configura o registrador de backup (BackupRegistrar) e o failover automático (EnableAutomaticFailover) do Registrador Registrar:atl-cs-001.litwareinc.com.