• Artigo

Move-CsAnalogDevice

 

Tópico modificado em: 2012-03-23

Transfere um ou mais dispositivos analógicos para um novo pool de Registrador. Um dispositivo analógico é um telefone ou outro dispositivo que esteja conectado à rede telefônica pública comutada (PSTN).

Sintaxe

Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-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 Microsoft 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 Move-CsAnalogDevice permite transferir um dispositivo analógico existente para um novo pool de Registrador.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserID

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. Os dispositivos analógicos, por padrão, 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.

Target

Obrigatório

FQDN

O nome de domínio totalmente qualificado (FQDN) (por exemplo: atl-cs-001.litwareinc.com) do pool de Registrador para o qual o dispositivo analógico deve ser transferido. Além de um pool de Registrador, o Destino também pode ser o FQDN de um provedor de hospedagem.

DomainController

Opcional

FQDN

Permite se conectar a um controlador de domínio especificado para transferir o dispositivo analógico. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome de computador (por exemplo: atl-cs-001) ou o seu FQDN (por exemplo: atl-cs-001.litwareinc.com).

ProxyPool

Opcional

FQDN

Esse parâmetro é usado somente para Microsoft Lync Online 2010. Não deve ser usado com uma implementação local do Lync Server.

Force

Opcional

Parâmetro de opção

Se presente, transfere o dispositivo analógico, mas exclui quaisquer dados associados (como políticas que foram atribuídas ao dispositivo). Se não estiver presente, o dispositivo será transferido, juntamente com quaisquer dados associados.

PassThru

Opcional

Parâmetro de opção

Permite passar um objeto de usuário através do pipeline que representa a conta de usuário sendo transferida. Por padrão, o cmdlet Move-CsAnalogDevice não canaliza objetos.

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

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

Tipos de Retorno

Por padrão, Move-CsAnalogDevice não retorna objetos ou valores. No entanto, se você incluir o parâmetro PassThru, o cmdlet retornará instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Exemplo

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

Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

O comando exibido no Exemplo 1 transfere o dispositivo analógico com a Identidade CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com para o pool de Registrador atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

No Exemplo 2, o dispositivo analógico que possui o nome de exibição "Building 14, Room 142" no Active Directory será transferido para o pool de Registrador atl-cs-001.litwareinc.com. Para realizar isso, chama-se primeiramente Get-CsAnalogDevice, sem nenhum parâmetro, para que retorne uma coleção de todos os dispositivos analógicos em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará todos os dispositivos cujo nome de exibição for "Edifício 14, Quarto 142". Essa coleção filtrada será canalizada para Move-CsAnalogDevice, que transferirá todos os dispositivos na coleção para o pool de Registrador atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

O comando anterior move todos os dispositivos analógicos que possuírem um nome de exibição que comece com o valor de cadeia de caracteres "Edifício 14". Para realizar essa tarefa, o comando chama primeiramente Get-CsAnalogDevice, para retornar uma coleção de todos os dispositivos analógicos em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará todos os dispositivos que possuírem um nome de exibição que comece com o valor de cadeia de caracteres "Edifício 14". A coleção filtrada será canalizada para Move-CsAnalogDevice, que transferirá cada dispositivo na coleção para o pool de Registrador atl-cs-001.litwareinc.com.