Compartilhar via

  • Artigo

Move-CsCommonAreaPhone

 

Tópico modificado em: 2012-03-23

Move um ou mais telefones de área comum para um novo pool de Registrador.

Sintaxe

Move-CsCommonAreaPhone -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Telefones de área comum são telefones IP que não estão associados a um usuário individual. Em vez de estarem localizados no escritório de alguém, esses telefones geralmente estão localizados em lobbies de edifícios, cafeterias, lounges para funcionários, salas de reuniões e outros locais que possam receber um grande número de pessoas. Isso é um desafio de gerenciamento para os administradores: o uso de um telefone no Lync Server 2010 geralmente é mantido usando-se várias diretivas de voz e planos de discagem, atribuídos a usuários individuais. Os telefones de área comum não são atribuídos a usuários individuais.

A solução é criar objetos de contato do Active Directory para todos os seus telefones de área comum. (esses objetos de contato podem ser criados com o cmdlet New-CsCommonAreaPhone). Assim como as contas de usuário, esses objetos de contato podem ser atribuídos a diretivas e planos de voz. Com isso, é possível manter o controle sobre os telefones de área comum mesmo que esses telefones não estejam associados a um usuário individual. Por exemplo, se você não quiser que as pessoas possam transferir ou estacionar chamadas em um telefone de área comum, crie uma diretiva de voz que proíba a transferência e o estacionamento de chamadas, e atribua essa diretiva ao telefone de área comum. (Ou, o que seria mais correto, atribuir essa diretiva ao objeto de contato que representa o telefone de área comum).

O cmdlet Move-CsCommonAreaPhone permite mover um telefone de área comum existente para um novo pool de Registrador.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

UserID

Identificador exclusivo do telefone de área comum. Os telefones de área comum são identificados usando-se o nome diferenciado do Active Directory do objeto de contato associado. Por padrão, telefones de área comum usam um GUID (identificador global exclusivo) como nome comum; ou seja, os telefones geralmente terão uma Identidade semelhante a esta: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Target

Obrigatório

FQDN

O FQDN (nome de domínio totalmente qualificado) do pool do Registrador para o qual o telefone de área comum deve ser movido; por exemplo: atl-cs-001.litwareinc.com. Além de um pool de Registrador, o Target pode ser também o FQDN de um provedor de hospedagem.

DomainController

Opcional

FQDN

Permite sua conexão ao controlador de domínio especificado para mover o telefone de área comum. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome do computador (por exemplo, atl-cs-001) ou por seu FQDN (por exemplo, atl-cs-001.litwareinc.com).

ProxyPool

Opcional

Nome de domínio totalmente qualificado

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

Force

Opcional

Parâmetros de Opção

Se presente, move o telefone de área comum mas exclui quaisquer dados associados (como diretivas que foram atribuídas ao dispositivo). Se não estiver presente, o telefone é movido junto com quaisquer dados associados.

PassThru

Opcional

Parâmetros de Opção

Permite que você passe um objeto de usuário através do pipeline que representa a conta de usuário que está sendo movida. Por padrão, o cmdlet Move-CsCommonAreaPhone não passa objetos pela pipeline.

WhatIf

Opcional

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

Cadeia de caracteres. Move-CsCommonAreaPhone aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de um telefone de área comum.

Tipos de Retorno

Por padrão, Move-CsCommonAreaPhone 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.OCSADCommonAreaPhoneContact.

Exemplo

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

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

O comando mostrado no Exemplo 1 move o telefone de área comum com 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-CsCommonAreaPhone | Where-Object {$_.DisplayName -eq "Building 31 Cafeteria"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

No Exemplo 2, o telefone de área comum com nome para exibição no Active Directory "Building 31 Cafeteria" é movido para o pool de Registrador atl-cs-001.litwareinc.com. Para fazer isso, Get-CsCommonAreaPhone é chamado primeiro, sem nenhum parâmetro, a fim de retornar uma coleção de todos os telefones de área comum atualmente em uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona apenas os telefones nos quais o atributo DisplayName seja igual a "Building 31 Cafeteria". Em seguida, a coleção filtrada é encaminhada para Move-CsCommonAreaPhone, que remove cada telefone na coleção para atl-cs-001.litwareinc.com.

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

O exemplo anterior move todos os telefones de área comum hospedados no pool de Registrador dublin-cs-001.litwareinc.com para o pool de Registrador atl-cs-001.litwareinc.com. Para executar esta tarefa, o comando primeiro chama Get-CsCommonAreaPhone sem nenhum parâmetro; isso retorna uma coleção de todos os telefones de área comum configurados para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona todos os telefones de área comum nos quais RegistrarPool seja igual a dublin-cs-001.litwareinc.com. Em seguida, essa coleção é encaminhada para Move-CsCommonAreaPhone, que move cada telefone na coleção para o novo pool de Registrador atl-cs-001.litwareinc.com.

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com -PassThru | Grant-CsVoicePolicy -PolicyName AtlantaVoicePolicy

O Exemplo 4 é uma variação do comando exibido no Exemplo 3; neste caso, porém, os telefones de área comum não apenas são movidos para um novo pool de Registrador como também são atribuídos a uma nova diretiva de voz por usuário. Para fazer isso, o parâmetro PassThru é incluído quando Move-CsCommonAreaPhone é chamado; isso é necessário para passar os objetos do telefone de área comum pela pipeline (por padrão, o cmdlet Move-CsCommonAreaPhone não passa objetos pela pipeline). Depois que os telefones forem movidos, os objetos de telefone são encaminhados para o cmdlet Grant-CsVoicePolicy, que atribui a diretiva de voz AtlantaVoicePolicy a todos os telefones recém-movidos.