Compartilhar via

  • Artigo

Remove-CsRegistrarConfiguration

 

Tópico modificado em: 2012-03-26

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

Sintaxe

Remove-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 Remove-CsRegistrarConfiguration permite remover definições de configuração do registrador que foram aplicadas no escopo do site ou do serviço. Observe que ele não exclui ou desinstala nenhum dos Registradores; ele só remove as definições de configuração que governam esses Registradores. Se essas configurações não existirem no escopo do site ou do serviço, um Registrador será gerenciado usando-se as configurações globais.

Remove-CsRegistrarConfiguration também pode ser executado com as definições de configuração globais do Registrador. Nesse caso, porém, as configurações não serão removidas; isso porque as configurações globais não podem ser excluídas. Em vez disso, serão restaurados os valores padrão de todas as propriedades na coleção global. Por exemplo, se você tiver alterado o valor da propriedade MinEndpointExpiration como 500, esse valor será redefinido como 300.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

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

Observe que Remove-CsRegistrarConfiguration também pode ser executado com as configurações globais (-Identity global). Nesse caso, no entanto, as configurações globais não serão removidas. Em vez disso, serão restaurados os valores padrão de todas as propriedades na coleção global.

Force

Obrigatório

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings. Remove-CsRegistrarConfiguration aceita instâncias em pipeline do objeto de configurações do Registrador.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsRegistrarConfiguration exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemplo

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

Remove-CsRegistrarConfiguration -Identity site:Redmond

O comando mostrado no Exemplo 1 exclui as definições de configuração do Registrador atribuídas ao site Redmond. Quando essas configurações forem excluídas, os Registradores no site Redmond usarão automaticamente as configurações globais do Registrador.

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

Get-CsRegistrarConfiguration -Filter "service:*" | Remove-CsRegistrarConfiguration

O comando anterior exclui todas as definições de configuração do Registrador atribuídas ao escopo do serviço. Para isso, o comando chama inicialmente Get-CsRegistrarConfiguration com o parâmetro Filter; o valor de filtro "service:*" limita os dados retornados às configurações nas quais Identity comece com os caracteres "service:". Em seguida, a coleção filtrada é redirecionada para Remove-CsRegistrarConfiguration, que exclui cada item da coleção.

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

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

No Exemplo 3, todas as definições de configuração do Registrador nas quais a propriedade EnableDHCPServer seja True são excluídas. 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. Em seguida, essa coleção é direcionada para o cmdlet Where-Object, que seleciona somente as configurações nas quais a propriedade EnableDHCPServer seja igual a True. Por sua vez, a coleção filtrada é redirecionada para Remove-CsRegistrarConfiguration, que exclui cada item da coleção.