Compartilhar via

  • Artigo

New-CsAnalogDevice

 

Tópico modificado em: 2012-03-23

Cria um novo dispositivo analógico que pode ser gerenciado, 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

New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os dispositivos analógicos incluem telefones, aparelhos de fax, modems e dispositivos TTY/TTD (Teletipo/Dispositivos de 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-se 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, 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, atribuindo políticas e planos de discagem ao contato.

O cmdlet New-CsAnalogDevice permite criar novos dispositivos analógicos. Esse cmdlet também pode criar novos objetos de contato para uso com dispositivos analógicos ou associar objetos de contato existentes a um novo dispositivo. Para obter mais detalhes, consulte as descrições dos parâmetros OU e DN nesse tópico.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

LineUri

Obrigatório

Cadeia de caracteres

Número de telefone do dispositivo analógico. O URI de linha deve ser especificado usando-se o formato E.164 e utilizando o prefixo "TEL:". Por exemplo: TEL: 14255551297. Qualquer número de ramal deve ser adicionado ao fim da linha URI, por exemplo: "TEL:+14255551297;ext=51297".

SipAddress

Opcional

endereço SIP

Identificador exclusivo (semelhante a um endereço de email) que permite ao dispositivo analógico se comunicar com dispositivos SIP, como o Microsoft Lync 2010. O endereço SIP deve ser precedido pelo prefixo "sip:". Por exemplo: sip:bldg14lobby@litwareinc.com.

RegistrarPool

Obrigatório

Cadeia de caracteres

Nome de domínio totalmente qualificado (FQDN) do pool de registradores no qual deve-se hospedar o objeto de contato. Por exemplo: -RegistrarPool "atl-cs-001.litwareinc.com".

DisplayName

Opcional

Cadeia de caracteres

Configura o nome de exibição do dispositivo analógico no Active Directory.

DisplayNumber

Opcional

Cadeia de caracteres

O número de telefone, como é exibido no Lync 2010. A propriedade DisplayNumber pode ser formatada de qualquer maneira. Por exemplo, 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234, etc.

AnalogFax

Obrigatório

Booleano

Defina como True ($True), se o dispositivo analógico for um aparelho de fax. Defina como False ($False), se o dispositivo não for um aparelho de fax.

Gateway

Obrigatório

Cadeia de caracteres

O endereço IP do gateway PSTN a ser utilizado pelo dispositivo analógico.

OU

Obrigatório

Nome diferenciado do Active Directory

Nome diferenciado da unidade organizacional (OU) do Active Directory na qual deve-se posicionar o objeto de contato. Por exemplo: -OU "ou=Redmond,dc=litwareinc,dc=com”.

Se o parâmetro OU for incluído, será criado um novo contato na OU especificada e um GUID (identificador global exclusivo) será automaticamente atribuído ao contato como seu nome comum. Como resultado, o objeto de contato terá um nome semelhante a esse: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

DN

Opcional

Nome diferenciado do Active Directory

Permite associar um objeto de contato existente do Active Directory ao dispositivo analógico. Se houver um objeto de contato ao qual se deseja associar um dispositivo analógico, utilize o parâmetro DN, seguido do nome diferenciado desse contato. Por exemplo: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Observe que o comando falhará se o contato especificado não existir.

Não é possível utilizar os parâmetros OU e DN no mesmo comando.

PassThru

Opcional

Parâmetro de opção

Retorna um objeto representando o telefone de área comum.

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

Nenhuma. New-CsAnalogDevice não aceita a entrada canalizada.

Tipos de Retorno

New-CsAnalogDevice cria novas instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemplo

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

New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"

O comando exibido no Exemplo 1 cria um novo dispositivo analógico com o número de telefone (LineUri) 1-425-555-6001 (observe que o número de telefone deve ser especificado utilizando-se o formato E.164). Além do parâmetro LineUri, os outros parâmetros utilizados nesse comando são DisplayName (para definir o nome de exibição do dispositivo no Active Directory), RegistrarPool (para especificar o pool de registradores), AnalogFax (definido como $False, para indicar que esse é um telefone e não um aparelho de fax), Gateway (definido como o endereço de IP do gateway) e OU (o nome diferenciado da OU do Active Directory na qual deve-se criar o objeto de contato do dispositivo).