Compartilhar via

  • Artigo

Remove-CsDialInConferencingAccessNumber

 

Tópico modificado em: 2012-03-25

Remove um número de acesso de conferência discada. A conferência discada permite aos usuários usar um telefone "comum" ou celular (ou seja, um dispositivo da Rede Telefônica Pública Comutada) para participar da parte de áudio de uma conferência.

Sintaxe

Remove-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A conferência discada permite que os usuários usem qualquer tipo de telefone (como uma linha fixa padrão, um telefone celular, um telefone VoIP, etc.) para participar da parte de áudio de uma conferência. Isso permite que os usuários participem da reunião mesmo se não possuírem um computador ou uma conexão à Internet. Os usuários possuem recursos completos de áudio: eles podem falar com outros participantes e ouvir tudo o que acontece. Eles só não poderão ver slides compartilhados, transmissões de vídeo ou outros elementos visuais.

Para oferecer aos usuários recursos de conferência discada, é necessário criar números de acesso a conferências discadas: os usuários de números de telefone poderão ligar para se conectar à reunião. Os números de acesso a conferências discadas são criados usando-se o cmdlet New-CsDialInConferencingAccessNumber. Na realidade, ao criar um novo número de acesso a conferências discadas, você estará criando um novo objeto de contato no Serviços de Domínio Active Directory (AD DS); esse objeto de contato é usado para representar o número de acesso e todas as suas propriedades. O cmdlet Remove-CsDialInConferencingAccessNumber permite excluir qualquer número de conferência discada criado, usando-se New-CsDialInConferencingAccessNumber. Ao se executar Remove-CsDialInConferencingAccessNumber, o cmdlet não só exclui o número da coleção de números de acesso a conferências discadas, mas também exclui o objeto de contato do Active Directory que representa o número de acesso em questão.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Endereço SIP

Endereço SIP do número de acesso de conferência discada (ou seja, o objeto de contato que representa o número) a ser removido. É necessário incluir o prefixo: sip: ao se especificar a Identidade. Por exemplo: -Identity "sip:RedmondDialIn@litwareinc.com".

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.Xds.AccessNumber. Remove-CsDialInConferencingAccessNumber aceita a entrada canalizada do objeto de número de acesso.

Tipos de Retorno

Remove-CsDialInConferencingAccessNumber exclui as instâncias do objeto Microsoft.Rtc.Management.Xds.AccessNumber.

Exemplo

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

Remove-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

O comando exibido no Exemplo 1 exclui o número de acesso a conferências discadas que possuir a Identidade sip:RedmondDialIn@litwareinc.com.

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

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1800*"} | Remove-CsDialInConferencingAccessNumber

O comando anterior exclui todos os números de acesso gratuitos a conferência discada. Nesse exemplo, isso significa qualquer número que possua um LineUri que comece com "tel:+1800". Para realizar isso, o comando usa Get-CsDialInConferencingAccessNumber e o parâmetro Filter, para retornar uma coleção de todos os números de acesso gratuito configurados para uso na organização. O valor de filtro {LineUri -like "tel:+1800*"} limita os dados retornados aos números cuja propriedade LineUri começa com o valor de cadeia de caracteres "tel:+1800". Esta coleção filtrada será então canalizada para Remove-CsDialInConferencingAccessNumber, que excluirá cada número na coleção.

-------------------------- Exemplo 3 ------------------------

Get-CsDialInConferencingAccessNumber -Region "Redmond" | Remove-CsDialInConferencingAccessNumber

No Exemplo 3, todos os números de acesso a conferências discadas da região de Redmond são excluídos. Para realizar essa tarefa, Get-CsDialInConferencingAccessNumber e o parâmetro Region são primeiramente chamados, para retornar uma coleção de todos os números de acesso da região de Redmond. (ou seja, qualquer número de acesso que inclua Redmond em sua lista de regiões.) Esta coleção será então canalizada para Remove-CsDialInConferencingAccessNumber, que excluirá todos os números de acesso na coleção.

-------------------------- Exemplo 4 ------------------------

Get-CsDialInConferencingAccessNumber -Region $Null | Remove-CsDialInConferencingAccessNumber

No Exemplo 4, todos os números de acesso a conferências discadas que não estiverem associados a uma região serão excluídos. Para isso, Get-CsDialInConferencingAccessNumber é chamado, juntamente com o parâmetro Region e o valor de parâmetro $Null; isso retornará uma coleção de números de acesso cuja propriedade Regions está vazia. Esta coleção será então canalizada para Remove-CsDialInConferencingAccessNumber, que excluirá todos os números na coleção.

-------------------------- Exemplo 5 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "it-IT"} | Remove-CsDialInConferencingAccessNumber

O comando exibido no Exemplo 5 exclui todos os números de acesso a conferências discadas nas quais o idioma principal não estiver definido como italiano. Para realizar isso, chama-se primeiramente Get-CsDialInConferencingAccessNumber sem nenhum parâmetro, para retornar uma coleção de todos os números de acesso à conferência discada configurados para uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará qualquer número cuja propriedade PrimaryLanguage não for igual a Italiano ("it-IT"). Finalmente, esta coleção será canalizada para Remove-CsDialInConferencingAccessNumber, que excluirá todos os números de acesso na coleção.

-------------------------- Exemplo 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default Dial-In Access Number"} | Remove-CsDialInConferencingAccessNumber

No Exemplo 6, será excluído o número de acesso à conferência discada com o nome de exibição "Default Dial-In Access Number". Para cumprir essa tarefa, chama-se Get-CsDialInConferencingAccessNumber, juntamente com o parâmetro Filter e o valor de filtro {DisplayName -eq "Default Dial-In Access Number"}. Esse valor de filtro limita os dados retornados ao número de acesso cuja propriedade DisplayName for igual a "Default Dial-In Access Number". O objeto retornado será então canalizado para Remove-CsDialInConferencingAccessNumber, que excluirá o número de acesso correspondente.