Compartilhar via


New-CsSimpleUrlConfiguration

 

Tópico modificado em: 2012-10-17

Cria uma nova coleção de configurações de URLs simples. As URL simples facilitam a participação dos usuários em reuniões e conferências. Elas também facilitam a entrada de Administradores no Painel de Controle do Microsoft Lync Server 2010.

Sintaxe

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

Descrição Detalhada

No Microsoft Office Communications Server 2007 R2, as reuniões tinham URLs com a seguinte aparência:

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 no Office Communications Server. Entretanto, os URL simples não são criados automaticamente. Ou seja, deve-se configurá-los manualmente. Além disso, também é necessário 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 a criação de três diferentes URLs simples:

Reunião – utilizado nas reuniões. Cada domínio SIP deve ter pelo menos um URL de Reunião.

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 de atualizar uma coleção de URLs simples, deve-se executar o cmdlet Enable-CsComputer.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-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 "New-CsSimpleUrlConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da nova coleção de configuração de URL simples. Como as novas coleções só podem ser criadas no escopo de site, a Identidade deve ser o prefixo "site:" seguido do nome do site. Por exemplo, esta sintaxe cria uma nova coleção para o site Redmond: -Identity "site:Redmond".

SimpleUrl

Opcional

Modificador de Lista PS

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

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet 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-se o cmdlet coincidente Set- deste cmdlet.

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

Este parâmetro não é usado com a versão local do Lync Server.

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

Nenhuma.

Tipos de Retorno

New-CsSimpleUrlConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.

Exemplo

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

New-CsSimpleUrlConfiguration -Identity "site:Redmond"

O comando apresentado no Exemplo 1 cria uma nova coleção de URLs simples para o site de Redmond. Como não há outros parâmetros além de Identity incluídos neste comando, a nova coleção não terá nenhum URL simples. Este comando falhará se o site de Redmond já hospedar uma coleção de URLs simples.

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

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

$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2 

New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}

O exemplo anterior mostra como é possível criar uma nova coleção de URLs simples que incluírem dois URLs simples (um para o gerenciamento de reuniões e o outro para conferências discadas). Para isso, o primeiro comando no exemplo usa New-CsSimpleUrlEntry para criar uma entrada de URL que aponte para https://dialin.litwareinc.com; esta entrada de URL será armazenada em uma variável denominada $urlEntry. O segundo comando cria outra entrada de URL, que aponta para https://meet.fabrikam.com.

Em seguida, utiliza-se o cmdlet New-CsSimpleUrl para criar uma instância somente em memória de um URL simples. Neste exemplo, define-se o componente URL como dialin; configura-se o domínio como um asterisco (*), define-se a propriedade ActiveUrl como https://dialin.fabrikam.com e define-se a propriedade SimpleUrl como $urlEntry. (a variável $urlEntry representa a entrada de URL criada no primeiro comando). Utiliza-se um comando similar para criar o URL simples de meet.fabrikam.com.

Depois que o URL tiver sido criado (e armazenado nas referências de objeto $simpleUrl e $simpleUrl2), o comando final no exemplo criará uma nova coleção de URL simples para o site de Redmond, adicionando os dois novos URLs somente em memória a essa coleção. O novo URL é adicionado à coleção utilizando-se o cmdlet New-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Add=$simpleUrl, $simpleUrl2}. Esta sintaxe adiciona os URLs armazenados nas referências de objeto $simpleUrl e $simpleUrl2 à propriedade SimpleUrl.