New-CsWebLink
Tópico modificado em: 2012-04-23
Cria um novo link da Web que aponta para o serviço 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
New-CsWebLink -Href <String> -Token <String>
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.
Gerenciar as definições de configuração da Descoberta Automática geralmente significa adicionar URLs de Descoberta Automática. Essas URLs devem ser criadas usando o cmdlet New-CsWebLink, com a URL resultante armazenada em uma variável e adicionada a uma coleção de definições de configuração de Descoberta Automática. As URLs de Descoberta Automática são baseadas nos domínios SIP usados em sua organização; os administradores geralmente criarão uma URL para ser usada por usuários fora do firewall da organização (por exemplo, http://LyncDiscover.litwareinc.com) e uma segunda URL (por exemplo, http://LyncDiscoverInternal.litwareinc.com) para ser usada pelos usuários dentro do firewall.
Quem pode executar este cmdlet: por padrão, os membros do grupo a seguir estão autorizados a executar o cmdlet New-CsWebLink localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Href |
Obrigatório |
String |
URL para o serviço Descoberta Automática, por exemplo: –Href "http://LyncDiscover.fabrikam.com" |
Token |
Obrigatório |
String |
Nome exclusivo a ser fornecido à URL. Por exemplo: -Token "Fabrikam" |
Tipos de Entrada
Nenhuma. New-CsWebLink não aceita a entrada canalizada.
Tipos de Retorno
Cria novas instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.WebLink.WebLink.
Exemplo
-------------------------- Exemplo 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
Os comandos mostrados no Exemplo 1 adicionam uma nova URL de Descoberta Automática (http://LyncDiscover.fabrikam.com) às definições de configuração da Descoberta Automática atribuídas ao site Redmond. Para fazer isso, o primeiro comando no exemplo usa o cmdlet New-CsWebLink para criar uma nova URL de Descoberta Automática; essa URL é armazenada em uma variável denominada $Link1. Em seguida, Set-CsAutoDiscoverConfiguration é usado para adicionar a nova URL a quaisquer URLs já atribuídas a essas definições. Isto é feito usando o parâmetro WebLinks e o valor de parâmetro @{Add=$Link1}.
-------------------------- Exemplo 2 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
$Link2 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscoverInternal.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1,$Link2}
Os comandos anteriores atribuem um par de URLs de Descoberta Automática (http://LyncDiscover.fabrikam.com e http://LyncDiscoverInternal.fabrikam.com) às definições de configuração da Descoberta Automática atribuídas ao site Redmond. 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 Set-CsAutoDiscoverConfiguration para atribuir as duas URLs ao site Redmond. Para fazer isso, 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 das definições.