Artigo
01/15/2015

New-CsAutodiscoverConfiguration

Tópico modificado em: 2012-04-23

Cria um novo conjunto de definições de configuração da Descoberta Automática no escopo local. 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

New-CsAutodiscoverConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WebLinks <PSListModifier>] [-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 local. Ao instalar o Lync Server, um conjunto global de definições será criado para você. No entanto, nenhuma URL de Descoberta Automática será atribuída a esse conjunto. Se um único conjunto de definições de Descoberta Automática não atender às suas necessidades, você poderá usar o cmdlet New-CsAutoDiscoverConfiguration para criar definições de configuração adicionais no escopo local.

Quem pode executar este cmdlet: por padrão, os membros do grupo a seguir estão autorizados a executar o cmdlet New-CsAutoDiscoverConfiguration localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	XDS Identity	Identificador exclusivo do conjunto de definições de configuração da Descoberta Automática a ser modificada. Para criar um conjunto configurado no escopo local, use uma sintaxe semelhante a esta: -Identity "site:Redmond"
WebLinks	Opcional	PS List Modifier	Conjunto de URLs de Descoberta Automática. Essas URLs devem ser criadas usando o cmdlet New-CsWebLink.
InMemory	Opcional	Switch Parameter	Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída de um comando for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações chamando o cmdlet Set-CsAutoDiscoverConfiguration.
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

New-CsAutoDiscoverConfiguration does not accept pipelined input.

Tipos de Retorno

Cria novas instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.

Exemplo

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

New-CsAutoDiscoverConfiguration -Identity "site:Redmond"

O comando mostrado no Exemplo 1 criam um novo conjunto de definições de configuração da Descoberta Automática para o local Redmond. Como o parâmetro WebLinks não foi incluído, essas definições não terão nenhuma URL de Descoberta Automática.

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

$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
$Link2 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscoverInternal.fabrikam.com"

New-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1,$Link2}

Os comandos anteriores criam um novo conjunto de definições de configuração da Descoberta Automática para o local Redmond e atribuem essas novas definições a um par de URLs de Descoberta Automática: http://LyncDisocver.fabrikam.com e http://LyncDiscoverInternal.fabrikam.com. Para executar essa tarefa, os primeiros dois comandos usam o cmdlet New-CsWebLink para criar as duas URLs de Descoberta Automática; as URLs recém-criadas serão armazenadas em variáveis denominadas $Link1 e $Link2. Após a criação das duas URLs, o terceiro comando usa o New-CsAutoDiscoverConfiguration para criar as novas definições de configuração da Descoberta Automática. Para atribuir as duas URLs a essas definições, o parâmetro WebLinks é incluído junto com o valor de parâmetro @{Add=$Link1,$Link2}. Essa sintaxe faz com que os valores armazenados nas variáveis $Link1 e $Link2 sejam adicionados à propriedade WebLinks.

Compartilhar via