Compartilhar via

  • Artigo

Set-CsAnalogDevice

 

Tópico modificado em: 2012-03-26

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

Sintaxe

Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Dispositivos analógicos incluem telefones, aparelhos de fax, modems e dispositivos TTY/TDD (para comunicação de surdos) conectados à PSTN (rede telefônica pública comutada). Ao contrário de dispositivos que tiram proveito do Enterprise Voice (ou seja, a solução de 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 costuma ser chamado de sinal analógico, de onde vem o termo "dispositivos analógicos".

Para permitir que administradores gerenciem dispositivos analógicos, o Lync Server 2010 permite associar dispositivos analógicos a objetos de contato do Active Directory Depois que um dispositivo é associado a um objeto de contato, é possível gerenciar o dispositivo analógico atribuindo diretivas e planos de discagem ao contato.

O cmdlet Set-CsAnalogDevice oferece uma maneira de modificar as propriedades de objetos de contato associados a dispositivos analógicos. Por exemplo, é possível alterar o nome para exibição do Active Directory do contato ou a linha URI associada ao dispositivo.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsAnalogDevice localmente: RTCUniversalUserAdmins. Permissões para executar este cmdlet para sites específicos ou OUs (unidades organizacionais) do Active Directory específicas podem ser atribuídas com o cmdlet Grant-CsOUPermission. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Parâmetro User ID

Identificador exclusivo para o dispositivo analógico a ser modificado. Os dispositivos analógicos são identificados usando o nome diferenciado do Active Directory do objeto de contato associado. Por padrão, dispositivos analógicos usam um GUID (identificador global exclusivo) como nome comum, ou seja, os dispositivos geralmente terão uma Identidade semelhante a esta: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Isso significa que pode ser mais fácil modificar os dispositivos analógicos usando o cmdlet Get-CsAnalogDevice para retornar os objetos de dispositivos analógicos e canalizar esses objetos para Set-CsAnalogDevice.

Gateway

Opcional

Cadeia de caracteres

Endereço IP do gateway PSTN a ser usado pelo dispositivo analógico.

AnalogFax

Opcional

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.

LineURI

Opcional

Cadeia de caracteres

Número de telefone do dispositivo analógico. A linha URI deve ser especificada usando o formato E.164 e levar 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 que permite que o dispositivo analógico se comunique com dispositivos SIP como o Microsoft Lync 2010. O endereço SIP deve levar o prefixo "sip:". Por exemplo: sip:bldg14lobby@litwareinc.com.

DisplayName

Opcional

Cadeia de caracteres

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

DisplayNumber

Opcional

Cadeia de caracteres

Número de telefone exibido no Lync 2010. A propriedade DisplayNumber pode ser formatada conforme a sua preferência; por exemplo, 1-800-555-1234; 1-(800)-555-1234; 1.800.555.1234; etc.

DomainController

Opcional

Parâmetros de Opção

Permite sua conexão ao controlador de domínio especificado para modificar as informações de contato. Para conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome de computador (por exemplo, atl-mcs-001) ou o seu FQDN (nome de domínio totalmente qualificado); por exemplo, atl-mcs-001.litwareinc.com.

Enabled

Opcional

Verdadeiro

Quando definido como True ($True), o dispositivo analógico pode ser usado com o Lync Server 2010.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica se o objeto de contato do dispositivo analógico foi habilitado ou não para o Enterprise Voice, a solução de protocolo VoIP oferecida pela Microsoft. Com o Enterprise Voice, chamadas telefônicas podem ser feitas usando a Internet em vez da rede telefônica padrão.

PassThru

Opcional

Parâmetros de Opção

Retorna um objeto representando o telefone de área comum.

WhatIf

Parâmetros de Opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de Opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact. Set-CsAnalogDevice aceita instâncias em pipeline do objeto de dispositivo analógico.

Tipos de Retorno

Por padrão, Set-CsAnalogDevice não retorna nenhum objeto ou valor. No entanto, se o parâmetro PassThru for incluído, o cmdlet irá retornar instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemplo

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

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

O comando anterior altera o valor da propriedade LineUri do dispositivo analógico com Identity CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

O comando mostrado no Exemplo 2 altera o gateway de todos os dispositivos analógicos que estejam usando o gateway 192.168.0.240 no momento. Para realizar essa tarefa, Get-CsAnalogDevice é chamado com o parâmetro Filter; o valor de filtro {Gateway -eq "192.168.0.240"} garante que apenas dispositivos com Gateway igual a (-eq) 192.168.0.240 sejam retornados. Esta coleção é então direcionada para Set-CsAnalogDevice, que seleciona cada item na coleção e altera o valor da propriedade Gateway para 192.168.1.100.