New-CsSimpleUrl
Tópico modificado em: 2012-10-17
Cria uma nova URL simples, que pode ser adicionada a uma coleção de configurações de URL simples. 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-CsSimpleUrl -Component <String> -Domain <String> [-ActiveUrl <String>] [-SimpleUrlEntry <PSListModifier>]
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ê deve ter pelo menos uma URL Meet para cada um dos domínios SIP.
Admin – Usada para apontar administradores na direção do 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: uma URL (como https://meet.litwareinc.com) que pode ser usada como uma URL simples (para fins de reunião, administração ou conferência discada). O objeto criado por New-CsSimpleUrlEntry é adicionado à propriedade SimpleUrlEntry de uma nova URL simples. Você deve usar um cmdlet para criar o objeto porque a propriedade SimpleUrlEntry pode manter várias URLs. (No entanto, apenas uma URL dessas pode ser designada como a URL ativa. A URL ativa representa a URL real usada para reuniões, administração ou conferência de discagem.)
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-CsSimpleUrl 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-CsSimpleUrl\b"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Component |
Obrigatório |
Cadeia de caracteres |
Indica o tipo de URL simples sendo criada. Os valores válidos são: Meet – URL usada para gerenciar reuniões. Admin – URL que aponta para o Painel de Controle do Lync Server 2010. Dialin – URL usada para conferência de discagem. Por exemplo: -Component "Meet". |
Domain |
Obrigatório |
Cadeia de caracteres |
Domínio SIP para a URL simples. Por exemplo: -Domain "litwareinc.com". |
SimpleUrlEntry |
Opcional |
PS List Modifier |
Coleção de URLs para o componente especificado. Por exemplo, tanto https://meet.litwareinc.com quanto https://litwareinc.com/meet podem ser configurados como entradas de URL para o componente Meet. No entanto, apenas uma dessas URLs pode ser (e deve ser) configurada com URL ativa. As entradas de URL simples devem ser criadas com o cmdlet New-CsSimpleUrlEntry. |
ActiveUrl |
Opcional |
Cadeia de caracteres |
Indica a URL a ser efetivamente acessada pelos usuários. A propriedade SimpleUrlEntry pode conter várias URLs, mas apenas uma dessas URLs pode permanecer ativa em um determinado momento. Ocorrerá um erro se você tentar definir a ActiveUrl como um valor não encontrado na propriedade SimpleUrlEntry. Para atribuir uma URL ativa, basta usar a própria URL como o valor de parâmetro. Por exemplo: -ActiveUrl https://meet.litwareinc.com". |
Tipos de Entrada
Nenhuma. New-CsSimpleUrl não aceita dados em pipeline.
Tipos de Retorno
New-CsSimpleUrl cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrl.
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.