Remove-CsAutodiscoverConfiguration
Tópico modificado em: 2012-04-23
Remove um conjunto de definições de configuração da Descoberta Automática. O serviço Descoberta Automática fornece uma maneira para aplicativos cliente (como o Lync Web Access ou o Microsoft Lync Mobile) localizarem recursos importantes, como o pool base de um usuário ou a URL para ingressar em uma conferência discada.
Sintaxe
Remove-CsAutodiscoverConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Para os aplicativos cliente usarem com mais eficiência o Microsoft Lync Server 2010, eles precisam conhecer o local os principais componentes do Lync Server 2010. Por exemplo, os usuários autenticados devem ser capazes de localizar seu pool base; afinal, eles só podem ser autenticados por esse pool base. Caso contrário, os usuários não autenticados deverão ser capazes de fazer coisas, como localizar a URL usada para participar de uma conferência.
Se todos os usuários conectados por trás do firewall da organização estiverem descobrindo esses locais, isso poderá ser uma tarefa relativamente simples. No entanto, essa tarefa relativamente simples se torna mais complicada à medida que os usuários acessam o sistema por locais externos usando o Microsoft Lync Mobile ou o Lync Web Access.
Isso é especialmente verdadeiro em uma situação de divisão de domínios, situações nas quais alguns usuários de uma organização têm contas na versão local do Lync Server enquanto outros usuários têm contas no Microsoft Office 365. Em casos como esse, as contas de usuário podem estar localizadas em florestas diferentes do Active Directory. Isso pode causar um problema: por exemplo, se um usuário baseado nos EUA fizer login pela Europa, o sistema deverá ser capaz de reconhecer a floresta dele e redirecionar a solicitação de login para o pool apropriado.
O serviço Descoberta Automática foi adicionado na versão de novembro de 2011 do Lync Server para corrigir esses problemas. Quando um aplicativo cliente tenta acessar o Lync Server, o serviço Descoberta Automática analisa o endereço SIP do cliente e redireciona a solicitação para o pool apropriado. Os aplicativos cliente se conectam ao serviço Descoberta Automática enviando uma solicitação HTTP a uma URL de Descoberta Automática; essas URLs devem ser configuradas pelos administradores para que o serviço Descoberta Automática funcione. Observe que, além de configurar URLs, os administradores também devem criar os registros DNS correspondentes a essas URLs.
As URLs de Descoberta Automática são atribuídas às definições de configuração da Descoberta Automática; por sua vez, essas definições podem ser aplicadas no escopo global ou no escopo local. Se você decidir remover as definições atribuídas ao escopo local, poderá fazê-lo executando o cmdlet Remove-CsAutoDiscoverConfiguration. Observe que esse cmdlet também pode ser executado nas definições globais. No entanto, nesse caso, as definições globais não serão removidas, mas quaisquer URLs de Descoberta Automática atribuídas ao conjunto global serão excluídas.
Quem pode executar este cmdlet: por padrão, os membros do grupo a seguir estão autorizados a executar o cmdlet Remove-CsAutoDiscoverConfiguration localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XDS Identity |
Identificador único para as definições de Descoberta Automática a serem removidas. As definições de Descoberta Automática podem ser configuradas no escopo global ou local. Para "remover" a política global, use esta sintaxe: -Identity global. Observe que as definições globais não podem realmente ser removidas. Em vez disso, todas as propriedades nas definições globais serão redefinidas para seus valores padrões. Para remover definições configuradas no escopo local, utilize uma sintaxe similar a esta: -Identity "site:Redmond" Observe que não é permitido o uso de caracteres curinga quando se especifica uma identidade. |
Force |
Opcional |
Switch Parameter |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Tipos de Entrada
Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration. Remove-CsAutoDiscoverConfiguration aceita a entrada canalizada dos objetos AutoDiscoverConfiguration
Tipos de Retorno
Nenhum. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Exemplo
-------------------------- Exemplo 1 -------------------------
Remove-CsAutoDiscoverConfiguration -Identity "site:Redmond"
O comando mostrado no Exemplo 1 exclui as definições de configuração da Descoberta Automática do local Redmond.
-------------------------- Exemplo 2 -------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*" | Remove-CsAutoDiscoverConfiguration
No Exemplo 2, todas as definições de configuração da Descoberta Automática atribuídas no escopo local são removidas. Para fazer isso, o comando usa primeiro o cmdlet Get-CsAutoDiscoverConfiguration e o parâmetro Filter para retornar um conjunto de definições de configuração; o valor do filtro "site:*" garante que somente as definições que têm uma Identidade que comece com o valor da cadeia de caracteres "site:" sejam retornados. Esse conjunto filtrado será canalizado para o Remove-CsAutoDiscoverConfiguration, que excluirá todos os itens no conjunto.