Compartilhar via

  • Artigo

Remove-CsAnalogDevice

 

Tópico modificado em: 2012-03-27

Remove um dispositivo existente da coleção de dispositivos analógicos que podem ser gerenciados usando-se o Microsoft Lync Server 2010. Um dispositivo analógico é um telefone ou outro dispositivo que esteja conectado à rede telefônica pública comutada (PSTN).

Sintaxe

Remove-CsAnalogDevice [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]

Descrição Detalhada

Os dispositivos analógicos incluem telefones, aparelhos de fax, modems e dispositivo TTY/TTD (Teletipo/Telecomunicação para Surdos) conectados à Rede telefônica pública comutada (PSTN). Diferentemente dos dispositivos que fazem uso do Enterprise Voice (a solução VoIP oferecida pela Microsoft), os dispositivos analógicos não transmitem informações usando pacotes digitais. Em vez disso, as informações são transmitidas usando um sinal contínuo. Esse sinal é comumente denominado sinal analógico; daí o termo "dispositivos analógicos".

Para permitir que os administradores gerenciem os dispositivos analógicos de organizações, o Lync Server 2010 permite associar os dispositivos analógicos a objetos de contato do Active Directory. Depois que um dispositivo tiver sido associado a um objeto de contato, será possível gerenciar o dispositivo analógico, atribuindo políticas e planos de discagem ao contato.

Com o tempo, talvez seja necessário excluir um objeto de contato associado a um dispositivo analógico. Por exemplo: se você desativar todos os seus aparelhos de fax, não será mais necessário ter dispositivos analógicos (e objetos de contato) associados a esses aparelhos. O cmdlet Remove-CsAnalogDevice permite excluir dispositivos analógicos. Ao se executar esse cmdlet, o dispositivo será excluído da lista de dispositivos analógicos retornados por Get-CsAnalogDevice. Além disso, o objeto de contato associado a esse dispositivo será excluído do Serviços de Domínio Active Directory (AD DS).

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsAnalogDevice localmente: RTCUniversalUserAdmins. É possível atribuir permissões para executar esse cmdlet em sites específicos ou unidades organizacionais (OUs) específicas do Active Directory, usando o cmdlet Grant-CsOUPermission. 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-CsAnalogDevice"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Nome diferenciado do Active Directory

Identificador exclusivo do dispositivo analógico a ser removido. Os dispositivos analógicos são identificados mediante o uso de um nome diferenciado (DN) do objeto de contato associado no Active Directory. Por padrão, esses dispositivos usam um GUID (identificador global exclusivo) como seu nome comum; isso significa que os dispositivos analógicos normalmente terão uma identidade semelhante a essa: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Por isso, talvez seja mais fácil recuperar dispositivos analógicos usando o cmdlet Get-CsAnalogDevice e depois canalizando os objetos retornados para Remove-CsAnalogDevice.

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.ADConnect.Schema.OCSADAnalogDeviceContact. Remove-CsAnalogDevice aceita instâncias canalizadas do objeto de dispositivo analógico.

Tipos de Retorno

Remove-CsAnalogDevice exclui instâncias existentes do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemplo

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

Remove-CsAnalogDevice -Identity "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com"

O exemplo 1 exclui o dispositivo analógico que possui a Identidade CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"} | Remove-CsAnalogDevice

O comando exibido no Exemplo 2 exclui qualquer dispositivo analógico ao qual tiver sido atribuído o nome de exibição "Recepcionista do Edifício 14". Para realizar essa tarefa, o comando primeiramente chama Get-CsAnalogDevice, juntamente com o parâmetro Filter; o valor de filtro {DisplayName -eq "Recepcionista do Edifício 14"} limita os objetos retornados a dispositivos analógicos nos quais a propriedade DisplayName for igual a "Recepcionista do Edifício 14". Os itens retornados serão então canalizados para Remove-CsAnalogDevice, que os removerá.

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

Get-CsAnalogDevice -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Remove-CsAnalogDevice

O comando precedente exclui todos os dispositivos analógicos aos quais tiver sido atribuída a política de voz RedmondVoicePolicy. Para isso, Get-CsAnalogDevice e o parâmetro Filter são usados para recuperar todos os dispositivos analógicos nos quais a propriedade VoicePolicy for igual a RedmondVoicePolicy. Esta coleção filtrada será então canalizada para o cmdlet Remove-CsAnalogDevice, que excluirá cada item na coleção.

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

Get-CsAnalogDevice -Filter {AnalogFax -eq $True} | Remove-CsAnalogDevice

O comando exibido no Exemplo 4 remove todos os aparelhos de fax analógicos que estiverem sendo usados na organização. Para realizar essa tarefa, chama-se primeiramente Get-CsAnalogDevice, juntamente com o parâmetro Filter; o valor de filtro {AnalogFax –eq $True} selecionará apenas os dispositivos cuja propriedade AnalogFax for igual a True. Por sua vez, esta coleção filtrada será canalizada para Remove-CsAnalogDevice, que removerá cada item na coleção.