Compartilhar via

  • Artigo

Get-CsAnalogDevice

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os 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.

Sintaxe

Get-CsAnalogDevice [-Identity] <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

Descrição Detalhada

Os dispositivos analógicos incluem telefones, aparelhos de fax, modems e dispositivos teletipo/de telecomunicação para surdos (TTY/TTD) que estiverem conectados à rede telefônica pública comutada (PSTN). Diferentemente dos dispositivos que fazem uso do Enterprise Voice (a solução de Voz sobre o Protocolo de Internet [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-se um sinal contínuo. Esse sinal é comumente denominado sinal analógico; daí o termo "dispositivos analógicos".

Além de telefones analógicos e telefones que fazem uso do Enterprise Voice, existe outra classe de telefones: telefones digitais não-IP. Estes telefones são exclusivos ao sistema PBX com o qual tiverem sido adquiridos e não podem ser gerenciados pelo uso dos cmdlets do Lync Server 2010.

Para permitir que os administradores gerenciem dispositivos analógicos para as organizações, o Lync Server 2010 permite associar 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, executando tarefas como a atribuição de políticas e planos de discagem ao contato.

O cmdlet Get-CsAnalogDevice permite recuperar informações sobre os dispositivos analógicos configurados para uso na organização. Se o cmdlet Get-CsAnalogDevice for chamado sem parâmetros, ele retornará informações sobre todos os dispositivos analógicos. Os parâmetros adicionais fornecem diversas formas de filtrar as informações. Por exemplo: é possível retornar todos os dispositivos que tiverem objetos de contato em uma OU específica ou todos os dispositivos analógicos localizados em um edifício específico.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsAnalogDevice localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. É possível atribuir permissões para executar esse cmdlet em sites específicos ou OUs específicas do Active Directory, usando-se o cmdlet Grant-CsOUPermission. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Parâmetro User ID

Identificador exclusivo do dispositivo analógico. Os dispositivos analógicos são identificados mediante o uso de um nome diferenciado do objeto de contato associado no Active Directory. Por padrão, os dispositivos analógicos utilizam um GUID (identificador global exclusivo) como seu nome comum. Isso significa que os dispositivos terão uma identidade similar a: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Credential

Opcional

Objeto PS Credential

Permite executar o cmdlet Get-CsAnalogDevice com credenciais alternativas. Isso pode ser necessário se a conta utilizada para fazer o logon no Windows não tiver os privilégios necessários para trabalhar com objetos de contato.

Para usar o parâmetro Credential, primeiramente utilize o cmdlet Get-Credential para criar um objeto PSCredential. Para obter mais detalhes, consulte o tópico da Ajuda referente ao cmdlet Get-Credential.

DomainController

Opcional

Cadeia de caracteres

Permite que você se conecte a um controlador de domínio especificado, para recuperar as informações de contato. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome de domínio totalmente qualificado (FQDN) do computador (atl-cs-001.litwareinc.com, por exemplo).

Filter

Opcional

Cadeia de caracteres

Permite limitar os dados retornados, filtrando-se atributos específicos a Lync Server 2010. Por exemplo, é possível limitar os dados retornados a objetos de contato de dispositivo analógico aos quais tenha sido atribuída uma diretiva de voz específica, ou a contatos aos quais não tenha sido atribuída uma diretiva de voz específica.

O parâmetro Filter usa a mesma sintaxe de filtragem do Windows PowerShell utilizada pelo cmdlet Where-Object. Por exemplo: um filtro que retorna apenas aparelhos de fax poderia ter a seguinte aparência, onde AnalogFax representa o atributo do Active Directory, -eq, o operador de comparação (igual a) e $True (uma variável interna do Windows PowerShell), o valor de filtro:

-Filter {AnalogFax -eq $True}

LdapFilter

Opcional

Cadeia de caracteres

Permite limitar os dados retornados, filtrando-se atributos genéricos do Active Directory (ou seja, atributos que não forem específicos a Lync Server 2010). Por exemplo, é possível limitar os dados retornados a objetos de contato aos quais tenha sido atribuído um departamento específico ou que estejam localizados em um edifício específico.

Ao criar filtros, o parâmetro LdapFilter usa a linguagem de consulta LDAP. Por exemplo, um filtro que retorna apenas objetos de contato representando dispositivos analógicos na cidade de Redmond poderia ter a seguinte aparência:

-LdapFilter "l=Redmond"

No filtro anterior, "I" representa o atributo do Active Directory (localidade), "=", o operador de comparação (igual a) e "Redmond", o valor de filtro.

OU

Opcional

Nome diferenciado do Active Directory

Permite retornar objetos de contato de uma unidade organizacional (OU) específica do Active Directory. Isto retorna dados da OU especificada e de todas as suas OUs filhas. Por exemplo: se a OU Financeiro tiver duas OUs filhas (AccountsPayable e AccountsReceivable), serão retornadas informações sobre os dispositivos analógicos de cada uma das OUs.

Ao especificar uma OU, utilize o nome diferenciado do contêiner. Por exemplo: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Opcional

Inteiro

Permite limitar o número de registros retornados por um comando. Por exemplo, para retornar sete dispositivos analógicos (independentemente de quantos dispositivos analógicos haja na floresta), inclua o parâmetro ResultSize e defina o valor do parâmetro como sendo 7. Observe que não há como garantir quais sete telefones serão retornados. Se ResultSize for definido como 7, mas houver apenas três dispositivos analógicos na floresta, o comando retornará estes dispositivos e concluirá sem erro.

O tamanho dos resultados pode ser definido como qualquer número inteiro entre 0 e 2.147.483.647, inclusive. Se o número for definido como 0, o comando será executado, mas nenhum dado será retornado.

Tipos de Entrada

Cadeia de caracteres. Get-CsAnalogDevice aceita um valor canalizado de cadeia de caracteres, que representa a Identidade do dispositivo analógico.

Tipos de Retorno

Get-CsAnalogDevice retorna instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemplo

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

Get-CsAnalogDevice

O comando apresentado no Exemplo 1 retorna uma coleção de todos os dispositivos analógicos configurados para uso na organização. Isto é feito chamando-se Get-CsAnalogDevice, sem qualquer parâmetro.

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

Get-CsAnalogDevice | Select-Object DisplayName, LineUri

No Exemplo 2, serão retornados apenas dois valores de propriedade (DisplayName e LineUri) correspondentes a todos os dispositivos analógicos na organização. Para conduzir esta tarefa, o comando primeiramente chama Get-CsAnalogDevice, sem qualquer parâmetro. Isso retorna todos os valores de propriedade de todos os dispositivos analógicos na organização. Esta coleção será então canalizada para o cmdlet Select-Object, que selecionará e exibirá apenas os valores correspondentes às propriedades DisplayName e LineUri.

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

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

O Exemplo 3 retorna informações sobre o dispositivo analógico que tiver o nome de exibição "Recepcionista do Edifício 14" no Active Directory. Para isso, o comando chama Get-CsAnalogDevice e o parâmetro Filter. O valor de filtro {DisplayName -eq "Recepcionista do Edifício 14"} limitará os objetos retornados a dispositivos analógicos cuja propriedade DisplayName for igual a "Recepcionista do Edifício 14".

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}

O comando anterior retorna todos os dispositivos analógicos configurados que estiverem associados ao gateway 192.168.0.240. Isto é feito chamando-se Get-CsAnalogDevice e incluindo-se o parâmetro Filter. O valor de filtro "192.168.0.240" garante que os únicos objetos retornados sejam dispositivos analógicos nos quais a propriedade Gateway for igual a 192.168.0.240.

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

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

O comando exibido no Exemplo 5 retorna informações sobre todos os aparelhos de fax analógicos na organização. Para realizar essa tarefa, o comando chama Get-CsAnalogDevice, juntamente com o parâmetro Filter. O valor de filtro {AnalogFax -eq $True} limita os objetos retornados a aparelhos de fax: dispositivos analógicos, nos quais a propriedade AnalogFax for igual a True.

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

Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}

No Exemplo 6, é retornado um único dispositivo analógico: o dispositivo cujo LineUri (número de telefone) for igual a +14255556001.

-------------------------- Exemplo 7 ------------------------

Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}

O Exemplo 7 retorna todos os dispositivos analógicos que tiverem um código de área 425 e o prefixo de telefone 555. Para realizar essa tarefa, utiliza-se Get-CsAnalogDevice, juntamente com o parâmetro Filter. O valor de filtro {LineUri -like "tel:+1425555*"} limita os dados retornados a dispositivos cuja propriedade LineUri começar com os caracteres "tel:+1425555". Isto é equivalente a um número de telefone que começa com os seguintes caracteres: 1425555 (1-425-555-1298, por exemplo).

-------------------------- Exemplo 8 ------------------------

Get-CsAnalogDevice -OU "ou=Telecommunications,dc=litwareinc,dc=com"

O comando anterior retorna uma coleção de todos os dispositivos analógicos que tiverem um objeto de contato na OU Telecomunicações do Serviços de Domínio Active Directory (AD DS). Para isso, chama-se Get-CsAnalogDevice, juntamente com o parâmetro OU. O valor do parâmetro limita os objetos retornados aos dispositivos analógicos que possuírem objetos de contato na OU com o nome diferenciado ou=Telecommunications,dc=litwareinc,dc=com.

-------------------------- Exemplo 9 ------------------------

Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"

O comando ilustrado pelo Exemplo 9 mostra como é possível retornar uma coleção de dispositivos analógicos e atribuir uma política de voz a cada dispositivo da coleção. Para isso, chama-se primeiramente Get-CsAnalogDevice, sem qualquer parâmetro. Isso retorna uma coleção de todos os dispositivos analógicos configurados para uso na organização. Esta coleção será então canalizada para o cmdlet Grant-CsVoicePolicy, que atribuirá a política de voz AnalogVoicePolicy a cada um dos dispositivos da coleção.