Compartilhar via


Remove-CsSimpleUrlConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma ou mais coleções de configurações de URL simples atualmente em uso na sua organização. As URLs simples facilitam a participação dos usuários em reuniões e conferências e o logon dos administradores no Painel de Controle do Microsoft Lync Server 2010.

Sintaxe

Remove-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

No Microsoft Office Communications Server 2007 R2, as reuniões online tinham URLs semelhantes a esta:

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

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 do tipo Meet para cada um de 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.

As coleções de configurações de URL simples são criadas com o cmdlet New-CsSimpleUrlConfiguration; em seguida, é possível adicionar cmdlets (como New-CsSimpleUrlEntry e Set-CsSimpleUrlConfiguration) para popular essas coleções com URLs simples. Se decidir posteriormente excluir uma ou mais dessas coleções no escopo do site, você poderá fazê-lo usando o cmdlet Remove-CsSimpleUrlConfiguration.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo da coleção de URLs simples a serem removidas. Para remover uma coleção do escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond." Observe que você não pode usar caracteres curinga ao especificar uma identidade.

Observe que você também pode executar o cmdlet na coleção global usando esta sintaxe: -Identity global. Nesse caso, no entanto, a coleção global não será excluída. Ao invés disso, todas as URLs simples contidas nessa coleção serão excluídas.

Tenant

Opcional

Guid

Este parâmetro não se aplica à versão local do Lync Server 2010.

Force

Opcional

Parâmetro de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

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. Remove-CsSimpleUrlConfiguration aceita instâncias em pipeline do objeto de configuração de URL simples.

Tipos de Retorno

Nenhuma.

Exemplo

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

Remove-CsSimpleUrlConfiguration -Identity "site:Redmond"

O comando mostrado no Exemplo 1 exclui a coleção de configurações de URL simples aplicada ao site Redmond. Esse comando exclui todas as URLs simples atribuídas ao site especificado.

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

Get-CsSimpleUrlConfiguration -Filter "site:*" | Remove-CsSimpleUrlConfiguration 

No Exemplo 2, todas as coleções de configurações de URLs simples aplicadas no escopo do site são excluídas. Para fazer isso, o comando usa primeiro Get-CsSimpleUrlConfiguration e o parâmetro Filter para retornar todas as coleções de URL simples configuradas no escopo do site; o valor de filtro "site:*" limita os dados retornados às coleções que possuam Identidade começando com o valor de cadeia de caracteres "site:". A coleção filtrada é então canalizada para o Remove-CsSimpleUrlConfiguration, que exclui cada item da coleção.