Compartilhar via

  • Artigo

Set-CsSimpleUrlConfiguration

 

Tópico modificado em: 2012-10-17

Modifica uma coleção existente de configurações de URLs simples. Os URL Simples facilitam a participação dos usuários em reuniões e conferências e a efetuação do logon no Painel de Controle do Microsoft Lync Server 2010, pelos administradores.

Sintaxe

Set-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsSimpleUrlConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

No Microsoft Office Communications Server 2007 R2, as reuniões possuem URLs semelhantes a este:

https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8\&key=EcznhLh5K5t

No entanto, esses URLs não são especialmente intuitivos e não são fáceis de transmitir para outras pessoas. Os URLs simples introduzidos no Lync Server 2010 ajudam a resolver esses problemas, fornecendo aos usuários URLs cuja aparência se assemelha mais a:

https://meet.litwareinc.com/kenmyer/071200

Os URLs simples constituem um aprimoramento em relação aos URLs utilizados na versão anterior do Office Communications Server. Entretanto, os URL simples não são criados automaticamente. Ou seja, deve-se configurá-los manualmente. Além disso, é necessároi também realizar ações como criar os registros do Sistema de nomes de domínio (DNS) de cada URL, configurar regras de proxy reverso para acesso externo, adicionar URLs simples aos certificados do Servidor Front-End, e assim por diante.

O Lync Server permite criar três URLs simples diferentes:

Reunião – utilizado para reuniões. Deve-se ter pelo menos um URL de Reunião para cada domínio SIP.

Admin – utilizado para apontar os administradores para o Painel de Controle do Lync Server 2010.

Dialin – utilizado para indicar a página da web referente à conferência discada.

Os URLs simples são armazenados nas coleções de configuração de URL simples. Ao se instalar o Lync Server, cria-se uma coleção global. Também é possível criar coleções personalizadas no escopo de site. Isso possibilita utilizar URL simples diferentes em todos os sites.

As coleções de configurações de URLs simples são criadas utilizando-se o cmdlet New-CsSimpleUrlConfiguration. É possível utilizar outros cmdlets (como New-CsSimpleUrl e Set-CsSimpleUrlConfiguration) para preencher essas coleções com URLs simples. Depois que as coleções tiverem sido criadas, Set-CsSimpleUrlConfiguration também permitirá modificar os URLs armazenados nessas coleções.

A inclusão de um URL simples em uma coleção é razoavelmente objetiva. Para começar, utilize New-CsSimpleUrl e New-CsSimpleUrlEntry, para criar um URL apenas na memória. Depois, utilize o comando Add, para adicionar o novo URL à coleção existente. Como alternativa, é possível utilizar o método Replace, para substituir todos os URLs existentes pelo novo.

A remoção de um URL de uma coleção é um pouco mais difícil porque primeiramente, é necessário criar uma nova referência de objeto a esse URL (uma que imite o URL existente) e, em seguida, utilizar essa referência de objeto e o método Remove para excluir o URL.

Depois de atualizar uma coleção de URLs simples, deve-se executar o cmdlet Enable-CsComputer.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsSimpleUrlConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSimpleUrlConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da coleção de URLs simples a serem modificados. Para modificar a coleção global, utilize a sintaxe a seguir: -Identity global. Para modificar uma coleção no escopo de site, utilize uma sintaxe semelhante a esta: -Identity "site:Redmond."

Se este parâmetro não for especificado, a coleção global será modificada.

Instance

Opcional

Objeto SimpleUrlConfiguration

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

SimpleUrl

Opcional

Modificador de Lista PS

URLs simples configurados para essa coleção. Esses URLs devem ser criados utilizando-se os cmdlets New-SimpleUrl e New-SimpleUrlEntry.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

Tenant

Opcional

Guid

Esse parâmetro não é usado com a versão local de Lync Server 2010.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration. Set-CsSimpleUrlConfiguration aceita instâncias canalizadas do objeto de configuração de URL simples.

Tipos de Retorno

Nenhuma.

Exemplo

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null

O comando exibido no Exemplo 1 remove todos os URLs simples do site de Redmond, mas não remove a coleção de URLs simples. (a coleção continuará a existir, mas não conterá mais nenhum URL.) Para isso, o comando utiliza o parâmetro SimpleUrl e define o valor de parâmetro como sendo um valor nulo ($Null). Isso remove todos os URLs simples da coleção.

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

$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}

O exemplo anterior mostra como se adicionar um novo URL a uma coleção existente de URLs simples. Inicialmente, o primeiro comando no exemplo utiliza New-CsSimpleUrlEntry, para criar uma entrada de URL que aponte para https://meet.fabrikam.com. Esta entrada de URL é armazenada em uma variável denominada $urlEntry.

No segundo comando, utiliza-se New-CsSimpleUrl para criar uma instância somente em memória de um URL simples. Neste exemplo, Componente URL é definido como Meet, o domínio é definido como fabrikam.com, ActiveUrl é definido como https://meet.fabrikam.com e a propriedade SimpleUrl é definida como $urlEntry. com $urlEntry é a entrada de URL criada no primeiro comando.

Depois que o URL tiver sido criado (e armazenado na referência do objeto $simpleUrl), o comando final no exemplo adiciona o novo URL à coleção de URL simples do site de Redmond. Isto é feito utilizando-se o cmdlet Set-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Add=$simpleUrl}. Esta sintaxe adiciona o URL armazenado na referência do objeto $simpleUrl à propriedade SimpleUrl.

-------------------------- Exemplo 3 ------------------------

$urlEntry = New-CsSimpleUrlEntry -Url "https://fabrikam.vdomain.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}

O comando exibido no Exemplo 3 mostra como é possível excluir um único URL de uma coleção de URL simples. Como Set-CsSimpleUrlConfiguration precisa trabalhar com objetos URL, o exemplo inicialmente criará um novo objeto que contém os mesmos valores de propriedade que o URL a ser excluído. Para fazer isso, o primeiro comando utiliza New-CsSimpleUrlEntry, para criar uma entrada de URL que aponte para https://meet.fabrikam.com. Esta entrada de URL é armazenada em uma variável denominada $urlEntry.

Depois que a entrada de URL tiver sido criada, o segundo comando utilizará New-CsSimpleUrl para criar uma instância apenas na memória de um URL simples. Neste exemplo, Componente URL é definido como Meet, o domínio é definido como fabrikam.com, ActiveUrl é definido como https://meet.fabrikam.com e a propriedade SimpleUrl é definida como $urlEntry. com $urlEntry é a entrada de URL criada no primeiro comando. Isso cria um URL na memória ($simpleUrl) que possui os mesmos valores de propriedade que o URL a ser excluído.

A seguir, o comando final no exemplo exclui o URL da coleção de URL simples do site de Redmond. Isto é feito utilizando-se o cmdlet Set-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Remove=$simpleUrl}. Esta sintaxe simplesmente remove o URL armazenado na referência de objeto $simpleUrl da propriedade SimpeUrl.