New-CsSimpleUrlEntry
Tópico modificado em: 2012-10-17
Cria uma nova entrada de URL simples, um elemento necessário ao criar uma URL simples. As URLs simples facilitam a participação dos usuários em reuniões e conferências, além de facilitar o logon dos administradores no Painel de Controle do Microsoft Lync Server 2010.
Sintaxe
New-CsSimpleUrlEntry -Url <String>
Descrição Detalhada
No Microsoft Office Communications Server 2007 R2, as reuniões online tinham URLs semelhantes a esta:
Porém, essas URLs não são especialmente intuitivas, nem muito fáceis de transmitir para alguém. As URLs simples introduzidas no Lync Server 2010 ajudam a superar esses problemas, fornecendo aos usuários URLs semelhantes a esta:
https://meet.litwareinc.com/kenmyer/071200
As URLs simples são um claro aperfeiçoamento das URLs usadas no Office Communications Server. No entanto, as URLs simples não são criadas automaticamente; você deve configurar as URLs por conta própria. Além disso, é preciso criar registros de DNS para cada URL, configurar regras de proxy reverso para acesso externo e adicionar as URLs simples aos seus certificados do Servidor Front-End, dentre outras coisas.
O Lync Server permite que você crie três URLs simples diferentes:
Meet – Usada para reuniões. Você precisa ter pelo menos uma URL Reunir para cada um dos seus domínios SIP.
Admin – utilizado para apontar os administradores para o Painel de Controle do Lync Server 2010.
Dialin – Usada para a página de conferência de discagem.
As URLs simples são armazenadas em coleções de configurações de URLs simples. Na instalação do Lync Server, uma coleção global é criada para você; também é possível criar coleções personalizadas no escopo do site. Isso possibilita o uso de URLs simples diferentes em cada um dos seus sites.
Para adicionar uma URL real a uma coleção de URLs simples, comece criando a URL usando os cmdlets New-CsSimpleUrl e New-CsSimpleUrlEntry. O cmdlet New-CsSimpleUrlEntry cria uma entrada de URL; isto não é nada mais do que uma URL (assim como https://meet.litwareinc.com) que pode ser usada como uma URL simples (para propósitos de reunião, administração ou discagem). O objeto criado por New-CsSimpleUrlEntry é então acrescentado à propriedade SimpleUrlEntry de uma nova URL simples. Você deve usar um cmdlet separado para criar o objeto porque a propriedade SimpleUrlEntry pode abrigar várias URLs. (No entanto, somente uma URL pode ser designada como a URL ativa. A URL ativa representa a URL de fato usada para reuniões, administração e conferência discada).
Depois de criar uma URL simples, use o cmdlet New-CsSimpleUrl para criar uma instância de uma URL simples apenas na memória, definindo coisas como o componente (o tipo da URL simples), o domínio, a URL ativa e todas as entradas de URL simples. Depois de criado um objeto representando a URL simples, esse objeto pode ser adicionado a uma nova coleção de URLs simples (ou a uma coleção existente). Depois de atualizar a coleção de URLs simples, execute o cmdlet Enable-CsComputer.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsSimpleUrlEntry localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrlEntry"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Url |
Obrigatório |
Cadeia de caracteres |
URL a ser adicionada à propriedade SimpleUrlEntry de uma URL simples. Por exemplo: -Url "https://meet.litwareinc.com". URLs precisam começar com "https:" como prefixo. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
New-CsSimpleUrlEntry cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrlEntry.
Exemplo
-------------------------- Exemplo 1 ------------------------
$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 uma nova URL pode ser adicionada a uma coleção de URLs simples existente. Para começar, o primeiro comando no exemplo usa New-CsSimpleUrlEntry para criar uma entrada de URL que aponta para https://meet.fabrikam.com; essa entrada de URL é armazenada em uma variável chamada $urlEntry.
No segundo comando, New-CsSimpleUrl é usada para criar uma instância apenas na memória de uma URL simples. Neste exemplo, o Componente URL é definido como Reunião; o domínio é definido como fabrikam.com; ActiveUrl é definida como https://meet.fabrikam.com e a propriedade SimpleUrl é definida como $urlEntry, com $urlEntry sendo a entrada de URL criada no primeiro comando.
Depois que a URL for criada (e armazenada na referência de objeto $simpleUrl), o comando final no exemplo adicionará a nova URL à coleção de URLs simples do site de Redmond. Isso é feito usando-se o cmdlet Set-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Add=$simpleUrl}. Essa sintaxe faz com que a URL armazenada na referência de objeto $simpleUrl seja adicionada à propriedade SimpleUrl.
-------------------------- Exemplo 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrl $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl, $simpleUrl2}
No Exemplo 2, um par de entradas de URL é adicionado a uma coleção existente de URLs simples. Para fazer isso, o primeiro comando no exemplo usa New-CsSimpleUrlEntry para criar uma entrada de URL que aponta para https://meet.fabrikam.com; esta entrada de URL é armazenada em uma variável chamada $urlEntry. O segundo comando cria então uma segunda entrada de URL, esta armazenada na variável $urlEntry2 e apontando para a URL https://dialin.fabrikam.com.
Depois que as duas entradas de URL forem criadas, New-CsSimpleUrl é usado para criar duas instâncias de uma URL simples em memória apenas. Na primeira instância, URL Component é definido como Meet; o domínio é definido como fabrikam.com; e ActiveUrl é definido como https://meet.fabrikam.com. Na segunda instância, o componente é definido como Dialin; o domínio como um asterisco (*); e a propriedade ActiveURL é definida como https://dialin.fabrikam.com.
Depois que as URLs forem criadas (e armazenadas nas referências de objeto $simpleUrl e $simpleUrl2), o comando final no exemplo adicionará a nova URL à coleção de URLs simples do site Redmond. Isso é feito usando-se o cmdlet Set-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Add=$simpleUrl, $simpleUrl2}. Essa sintaxe faz com que as URLs armazenada nas referências de objeto $simpleUrl e $simpleUrl2 sejam adicionadas à propriedade SimpleUrl.