Get-CsSimpleUrlConfiguration
Tópico modificado em: 2012-03-23
Retorna informações sobre as URLs simples configuradas para uso na organização. 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
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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. (é 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 – 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.
O cmdlet Get-CsSimpleUrlConfiguration é uma maneira de recuperar informações sobre todas as coleções de configurações de URLs simples em uso atualmente em sua organização.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsSimpleUrlConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsSimpleUrlConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Identificador exclusivo para a coleção de URLs simples a ser retornada. Para retornar a coleção global, use esta sintaxe: -Identity global. Para retornar uma coleção a partir do escopo de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond." Observe não ser possível usar curingas durante a especificação de uma Identity. Para usar curingas, use o parâmetro Filter. Chamar Get-CsSimpleUrlConfiguration sem parâmetros retorna todas as URLs simples configuradas para uso na organização. |
Filter |
Opcional |
Cadeia de caracteres |
Permite o uso de caracteres curinga ao especificar uma ou mais coleções de URLs simples a serem retornadas. Por exemplo, esta sintaxe retorna todas as coleções de URLs simples que tenham sido configuradas em escopo de site: -Filter "site:*". Observe que não é possível usar os parâmetros Filter e Identity no mesmo comando. |
Tenant |
Opcional |
Guid |
Este parâmetro não é usado com a versão local do Lync Server 2010. |
LocalStore |
Opcional |
Parâmetros de opção |
Obtém os dados de configuração de URL simples a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Get-CsSimpleUrlConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsSimpleUrlConfiguration
O comando anterior retorna informações sobre todas as coleções de configurações de URLs simples em uso atualmente na organização. Para isso, Get-CsSimpleUrlConfiguration é chamado sem parâmetros adicionais.
-------------------------- Exemplo 2 ------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
No Exemplo 2, as informações são retornadas para uma única coleção de configurações de URLs simples: a configuração com Identity site:Redmond.
-------------------------- Exemplo 3 ------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
O Exemplo 3 retorna informações de todas as coleções de configurações de URLs simples que tenham sido atribuídas ao escopo de site. Para fazer isso, Get-CsSimpleUrlConfiguration é chamado, junto com o parâmetro Filter; o valor de filtro "site:*" limita os dados retornados às coleções que tenham Identity começando com o valor de cadeia de caracteres "site:".
-------------------------- Exemplo 4 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
No Exemplo 4, são exibidas informações detalhadas de cada URL simples configurada para uso na organização. Para realizar esta tarefa, o comando chama primeiro o cmdlet Get-CsSimpleUrlConfiguration para retornar um conjunto completo de informações de URLs simples. Esses dados são canalizados para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para "expandir" o valor da propriedade SimpleUrl. A expansão do valor de uma propriedade exibe todos os dados armazenados nessa propriedade em um formato de fácil leitura.
-------------------------- Exemplo 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
O comando mostrado no Exemplo 5 retorna todas as URLs simples para gerenciamento de reuniões em uso atualmente em sua organização. Para isso, o comando chama primeiro o cmdlet Get-CsSimpleUrlConfiguration sem parâmetros adicionais; isso retorna um conjunto completo de informações de URLs simples. Esses dados são canalizados para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para expandir o valor da propriedade SimpleUrl. A coleção filtrada é então canalizada para o cmdlet Where-Object, que seleciona apenas as URLs simples nas quais a propriedade Component seja igual a "Meet".
Consulte Também
Outros Recursos
New-CsSimpleUrlConfiguration
Remove-CsSimpleUrlConfiguration
Set-CsSimpleUrlConfiguration