Compartilhar via

  • Artigo

Move-CsExUmContact

 

Tópico modificado em: 2012-03-23

Transfere um ou mais contatos do Unificação de Mensagens (UM) do Exchange para um novo pool de registradores.

Sintaxe

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

Descrição Detalhada

O Microsoft Lync Server 2010 funciona em conjunto com o UM do Exchange para fornecer várias capacidades relacionadas à voz, incluindo o Atendedor Automático e o Acesso de Assinante. O cmdlet Move-CsExUmContact permite transferir um objeto de contato existente, do UM do Exchange para um novo pool de registradores. Os objetos de contato podem ser transferidos de um pool do Microsoft Office Communications Server 2007 ou Microsoft Office Communications Server 2007 R2 para um pool do Lync Server 2010, ou de um pool do Lync Server 2010 para outro. Este cmdlet não transfere um objeto de contato de um pool do UM do ExchangeLync Server 2010 para um pool do Office Communications Server 2007 ou do Office Communications Server 2007 R2.

Quando se transfere um objeto de contato do UM do Exchange, as propriedades AutoAttendant e IsSubscriberAccess são definidas adequadamente, com base no valor da propriedade OtherIpPhone do objeto.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Move-CsExUmContact localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

O identificador exclusivo do objeto de contato que você deseja transferir. As Identidades de contato podem ser especificadas usando-se um de quatro formatos: 1) O endereço SIP do contato; 2) o Nome Principal Universal do usuário (UPN); 3) o nome de domínio do contato e nome de logon, na forma domínio\logon (por exemplo, litwareinc\exum1); e, 4) o nome de exibição dos Serviços de Domínio Active Directory do contato (por exemplo, Atendente Automático da Equipe).

Target

Obrigatório

Fqdn

O nome de domínio totalmente qualificado (FQDN) do pool de registradores para o qual o contato está sendo transferido.

Confirm

Opcional

SwitchParameter

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

DomainController

Opcional

Fqdn

Permite estabelecer a conexão com o controlador de domínio especificado. Para estabelecer conexão com um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome de computador (atl-mcs-001, por exemplo) ou do seu FQDN (atl-mcs-001.litwareinc.com, por exemplo).

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

PassThru

Opcional

SwitchParameter

Permite canalizar um objeto de contato através do pipeline que representa a conta de contato que está sendo transferida. Por padrão, o cmdlet Move-CsExUmContact não canaliza objetos.

ProxyPool

Opcional

Fqdn

Este parâmetro é usado apenas com instâncias hospedadas do Lync Server. Não deve ser usado com uma implementação local do Lync Server.

WhatIf

Opcional

SwitchParameter

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

Tipos de Entrada

Cadeia de caracteres. Aceita um valor canalizado de cadeia de caracteres representando a Identidade de um objeto do UM do Exchange a ser transferido.

Tipos de Retorno

Quando chamado com o parâmetro PassThru, retorna um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Exemplo

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

Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com

O exemplo 1 transfere o objeto de contato do UM do Exchange com o endereço SIP exum1@fabrikam.com para o pool Registrar com o FQDN atl-cs-001.litwareinc.com. Observe que será exibido um aviso de confirmação quando se executar este comando, mesmo que o parâmetro Confirm não tenha sido incluído. Este aviso aparecerá mesmo se o parâmetro Force for incluído.

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

Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com

Este exemplo transfere todos os objetos de contato do UM do Exchange que forem Atendedores Automáticos para o pool Registrar com o FQDN atl-cs-001.litwareinc.com. Este exemplo começa com uma chamada a Get-CsExUmContact, que irá recuperar todos os contatos do UM do Exchange que tiverem sido definidos. Esta coleção de contatos será então canalizada para o cmdlet Where-Object, que localizará todos os contatos na coleção cuja propriedade AutoAttendant estiver definida com o valor True ($True), indicando que o contato é um Atendedor Automático.

Finalmente, a coleção de contatos na qual AutoAttendant for True será canalizada para o cmdlet Move-CsExUmContact, que transferirá estes contatos para o pool de registradores especificado no parâmetro Target.

Como no Exemplo 1, será solicitada uma confirmação ao se executar este comando.