Get-CsAutodiscoverConfiguration
Tópico modificado em: 2012-04-23
Retorna informações sobre as definições de configuração da Descoberta Automática sendo usadas no momento em uma organização. 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 participar de uma conferência discada.
Sintaxe
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Para os aplicativos cliente usarem com mais eficiência o Microsoft Lync Server 2010, eles precisam conhecer a localização dos 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 local. O cmdlet Get-CsAutoDiscoverConfiguration fornece uma maneira de retornar as informações sobre as definições de Descoberta Automática (e as URLs de Descoberta Automática) sendo usadas no momento em sua organização.
Quem pode executar este cmdlet: por padrão, os membros do grupo a seguir estão autorizados a executar o cmdlet Get-CsAutoDiscoverConfiguration localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XDS Identity |
Identificador exclusivo do conjunto de definições de configuração da Descoberta Automática a ser recuperada. Para recuperar as definições globais, use a seguinte sintaxe: -Identity "global" Para recuperar as definições configuradas no escopo local, utilize uma sintaxe similar a esta: -Identity "site:Redmond" Se esse parâmetro não for incluído, Get-CsAutoDiscoverConfiguration retornará todas as definições de configuração de Descoberta Automática em uso na organização. |
Filter |
Opcional |
String |
Permite utilizar caracteres curinga ao se especificar a Identidade das definições de configuração de Descoberta Automática a serem retornadas. Por exemplo, esta sintaxe retorna todas as definições configuradas no escopo local: -Filter "site:*" Observe que não é possível utilizar os parâmetros Filter e Identity no mesmo comando. |
LocalStore |
Opcional |
Parâmetro de opção |
Recupera os dados de configuração da Descoberta Automática a partir da réplica local do repositório de Gerenciamento Central, e não do repositório de Gerenciamento Central em si. |
Tipos de Entrada
Get-CsAutoDiscoverConfiguration não aceita a entrada canalizada.
Tipos de Retorno
Get-CsAutoDiscoverConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsAutoDiscoverConfiguration
O comando exibido no Exemplo 1 retorna todas as definições de configuração de Descoberta Automática em uso na organização.
-------------------------- Exemplo 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
No Exemplo 2, somente um conjunto de definições de configuração da Descoberta Automática é retornado: o conjunto global.
-------------------------- Exemplo 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
O comando anterior retorna todas as definições de configuração da Descoberta Automática atribuídas no escopo local. Para fazer isso, o parâmetro Filter é incluído com o valor de filtro "site:*"; esse valor de filtro garante que as definições retornadas sejam somente aquelas que tenham uma Identidade que comece com o valor da cadeia de caracteres "site:". Por definição, quaisquer definições que têm uma Identidade começando com "site:" são as definições configuradas no escopo local.
-------------------------- Exemplo 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
O comando mostrado no Exemplo 4 retorna todas as definições de configuração da Descoberta Automática que incluem uma URL de Descoberta Automática para fabrikam.com. Para realizar essa tarefa, o comando usa primeiro o Get-CsAutoDiscoverConfiguration para retornar um conjunto de todas as definições de Descoberta Automática em uso na organização. Esse conjunto será canalizado para o cmdlet Where-Object, que selecionará somente as definições nas quais a propriedade WebLinks incluir o valor da cadeia de caracteres "fabrikam.com"