Set-CsAutodiscoverConfiguration

 

Tópico modificado em: 2012-04-23

Modifica um conjunto existente de definições de configuração da Descoberta Automática. O serviço Descoberta Automática fornece uma maneira para os aplicativos cliente (como o Lync Web App ou Lync Mobile ) localizarem recursos importantes, como o pool base de um usuário ou a URL para participar de uma conferência discada. UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010CU4)

Sintaxe

Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Set-CsAutodiscoverConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-EnableCertificateProvisioningServiceUrl <$true | $false>] [-ExternalSipClientAccessFqdn <String>] [-ExternalSipClientAccessPort <UInt32>] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Exemplos

EXEMPLO 1

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 local 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. No segundo comando, o cmdlet 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}.

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

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}

EXEMPLO 2

Os comandos mostrados no Exemplo 2 demonstram como você pode remover uma URL de um conjunto de definições de configuração do Serviço de Descoberta Automática. Para fazer isso, o primeiro comando na coleção obtém uma referência de objeto para a URL a ser excluída (uma URL que tem um Token igual a "Fabrikam"). Isso é feito chamando o cmdlet Get-CsAutoDiscoverConfiguration para obter as definições do Serviço de Descoberta Automática para o local Redmond. Esse conjunto será canalizado para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para "expandir" a propriedade WebLinks. Quando uma propriedade é expandida, isso permite que o Get-CsAutoDiscoverConfiguration acesse os objetos individuais armazenados nessa propriedade. Esses objetos WebLinks serão canalizados para o cmdlet Where-Object, que seleciona o objeto no qual a propriedade Token é igual a "Fabrikam". Esse objeto WebLinks será armazenado em uma variável denominada $Link1.

Em seguida, o segundo comando no exemplo usa o cmdlet Set-CsAutoDiscoverConfiguration para remover o objeto armazenado em $Link1. Para fazer isso, o comando usa o parâmetro WebLinks e o valor de parâmetro @{Remove=$Link1}.

$Link1 = Get-CsAutoDiscoverConfiguration  -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}

EXEMPLO 3

O Exemplo 3 mostra como você pode substituir um conjunto existente de URLs de Descoberta Automática por, neste caso, uma única URL. Para executar essa tarefa, o primeiro comando no exemplo usa o cmdlet New-CsWebLink para criar uma nova URL de Descoberta Automática para http://LyncDiscover.contoso.com; a URL resultante é armazenada em uma variável denominada $Link2. Em seguida, o segundo comando usa o cmdlet Set-CsAutoDiscoverConfiguration e o parâmetro WebLinks para remover quaisquer URLs atribuídas anteriormente ao local Redmond e substituí-las pela URL para http://LyncDiscover.contoso.com. Para fazer isso, o comando usa o método Substituir, em vez do método Adicionar ou remover.

$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}

EXEMPLO 4

O comando mostrado no Exemplo 4 remove todas as URLs de Descoberta Automática que foram atribuídas ao local Redmond. Para fazer isso, o comando define a propriedade WebLinks como um valor nulo. Por sua vez, exclui quaisquer URLs atribuídas anteriormente a essa propriedade.

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null

Descrição Detalhada

Para os aplicativos clientes usarem com mais eficiência o Lync Server, eles precisam conhecer o local dos principais componentes do Lync Server. Por exemplo, os usuários autenticados devem ser capazes de localizar seu pool base; afinal, eles só podem ser autenticados por esse pool base. Da mesma forma, 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 Lync Mobile ou Lync Web App.

Isso é especialmente verdadeiro em cenários de divisão de domínios, nos quais alguns usuários da organização têm contas na versão local do Lync Server, enquanto outros usuários têm contas no UNRESOLVED_TOKEN_VAL(nm-office-365-short). 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 sua floresta e redirecionar a solicitação de login para o pool apropriado.

O serviço Descoberta Automática foi introduzido na atualização cumulativa 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 para 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 do serviço 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. Nesse escopo, será possível usar o cmdlet Set-CsAutoDiscoverConfiguration para adicionar ou remover URLs de Descoberta Automática do conjunto global ou de qualquer conjunto no escopo local.

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

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Confirm	Opcional	System.Management.Automation.SwitchParameter	Solicita confirmação antes de executar o comando.
EnableCertificateProvisioningServiceUrl	Opcional	System.Boolean	Ao definir como Verdadeiro, habilita o serviço de descoberta automática para recuperar e armazenar a URL no serviço de provisionamento de certificado.
ExternalSipClientAccessFqdn	Opcional	System.String	Nome de domínio totalmente qualificado (FQDN) do servidor utilizado para acesso externo do cliente.
ExternalSipClientAccessPort	Opcional	System.UInt32	Porta utilizada para acesso externo do cliente.
Force	Opcional	System.Management.Automation.SwitchParameter	Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.
Identity	Opcional	Microsoft.Rtc.Management.Xds.XdsIdentity	Identificador exclusivo do conjunto de definições de configuração da Descoberta Automática a ser modificado. Para modificar o conjunto global, use a seguinte sintaxe: -Identity "global" Para modificar um conjunto configurado no escopo local, use uma sintaxe semelhante a esta: -Identity "site:Redmond" Se esse parâmetro não for especificado, o cmdlet Set-CsAutoDiscoverConfiguration modificará automaticamente as definições globais.
Instance	Opcional	Objeto AutoDiscoverConfiguration	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.
WebLinks	Opcional	System.Management.Automation.PSListModifier	Conjunto de URLs de Descoberta Automática. Essas URLs devem ser criadas usando o cmdlet New-CsWebLink.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Descreve o que aconteceria se você executasse o comando sem realmente executá-lo.

Tipos de Entrada

O cmdlet Set-CsAutoDiscoverConfiguration aceita a entrada canalizada do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.

Tipos de Retorno

Nenhum. O cmdlet Set-CsAutoDiscoverConfiguration modifica as instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.