Compartilhar via

  • Artigo

Remove-CsConferenceDirectory

 

Tópico modificado em: 2012-03-25

Remove um diretório de conferência existente. Os diretórios de conferências são usados para ajudar os usuários de conferências discadas a localizar as informações da conferência.

Sintaxe

Remove-CsConferenceDirectory -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Ao se criar um Identificador de recurso uniforme (URI) de conferência discada, atribui-se um endereço SIP exclusivo a esse URI. No entanto, é difícil converter os endereços SIP para dispositivos que não sejam compatíveis com SIP. Por exemplo: um telefone da rede telefônica pública comutada (PSTN) não pode converter um endereço SIP. Por isso, o Microsoft Lync Server 2010 usa diretórios de conferências como uma maneira de contribuir para que esses dispositivos localizem e se conectem com conferências discadas. Isso é realizado criando-se um diretório de conferência SIP que esteja associado a cada URI de conferência discada e que seja identificado por um valor inteiro, em vez de um URI do SIP. Assim, telefones e outros dispositivos da PSTN podem usar esses números, em vez de um URI SIP ao se conectarem a conferências. O número do diretório é incluído na identificação da conferência PSTN inserida pelos usuários durante a conexão com uma conferência discada.

Os diretórios de conferência são criados usando-se o cmdlet New-CsConferenceDirectory. Ocasionalmente, será necessário excluir um ou vários desses diretórios. Por exemplo: pode ser necessário desativar o pool no qual foram hospedados os diretórios. Os diretórios de conferências podem ser removidos, chamando-se o cmdlet Remove-CsConferenceDirectory. Observe que, se for necessário transferir um diretório de um pool para outro, isso poderá ser feito chamando-se o cmdlet Move-CsConferenceDirectory.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsConferenceDirectory localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsConferenceDirectory"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identidade numérica do diretório de conferência a ser removido.

Force

Opcional

Parâmetro de opção

Quando estiver presente, remove o diretório de conferência mesmo se o pool que hospeda o diretório estiver indisponível. Por padrão, Remove-CsConferenceDirectory não removerá os diretórios se o pool correspondente não puder ser contatado.

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.PstnConf.ConferenceDirectories. Remove-CsConferenceDirectory aceita entradas canalizadas dos objetos do diretório da conferências.

Tipos de Retorno

Nenhuma. Em vez disso, Removes-CsConferenceDirectory exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Exemplo

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

Remove-CsConferenceDirectory -Identity 2

O comando apresentado no Exemplo 1 exclui o diretório de conferências cuja Identidade for 2.

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

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"} | Remove-CsConferenceDirectory

O comando anterior exclui todos os diretórios de conferências encontrados no serviço UserServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando chama primeiramente Get-CsConferenceDirectory, sem nenhum parâmetro, retornando uma coleção de todos os diretórios de conferências em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os diretórios hospedados no serviço UserServer:atl-cs-001.litwareinc.com. Por sua vez, essa coleção filtrada será então canalizada para o cmdlet Remove-CsConferenceDirectory, que a excluirá.