Move-CsApplicationEndpoint
Tópico modificado em: 2012-03-23
Move um ponto de extremidade para um pool de Registrador diferente.
Sintaxe
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Esse cmdlet move um objeto de contato do ponto de extremidade existente no Serviços de Domínio Active Directory (AD DS) de um pool de aplicativos do Microsoft Office Communications Server 2007 R2 para um pool de aplicativos do Microsoft Lync Server 2010, ou de um pool de aplicativos do Lync Server 2010 para outro. O aplicativo associado ao ponto de extremidade indicado deve estar no pool de destino. Para determinar qual aplicativo está associado ao ponto de extremidade, execute o cmdlet Get-CsTrustedApplicationEndpoint ou Get-CsDialInConferencingAccessNumber.
Este cmdlet também é usado para atualizar as propriedades do objeto de contato do Active Directory quando um aplicativo implantado no Office Communications Server 2007 R2 é redirecionado para o Lync Server 2010. Observe que o pool de aplicativos de origem e destino será o mesmo nesse caso. Além disso, se um aplicativo criado originalmente para o Office Communications Server 2007 R2 for implantado diretamente no Lync Server 2010, este cmdlet terá que ser usado com o sinalizador Force para atualizar as propriedades do objeto de contato do Active Directory.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Move-CsApplicationEndpoint localmente: RTCUniversalUserAdmins. 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-CsApplicationEndpoint"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
PrimaryUriParameter |
O endereço SIP do DN (nome diferenciado) do contato do ponto de extremidade que você deseja mover. |
TargetApplicationPool |
Obrigatório |
Fqdn |
O nome de domínio totalmente qualificado (FQDN) do pool para o qual o ponto de extremidade está sendo movido. O pool de destino deve ter uma dependência do serviço Registrador. |
DomainController |
Opcional |
Fqdn |
Permite especificar um controlador de domínio. Se nenhum controlador de domínio for especificado, será usado o primeiro disponível. |
Force |
Opcional |
SwitchParameter |
Esta opção é necessária se você estiver movendo um objeto de contato do Microsoft Unified Communications Managed API (UCMA) 2,0 para o mesmo pool, mas em uma implantação do Lync Server 2010. Isso força o roteamento a se dar pelo Registrador do Lync Server 2010. |
PassThru |
Opcional |
SwitchParameter |
A especificação do parâmetro retornará o objeto do ponto de extremidade do aplicativo depois que o objeto tiver sido movido. |
WhatIf |
Opcional |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Cadeia de caracteres. Aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de um ponto de extremidade de aplicativo.
Tipos de Retorno
Quando usado com o parâmetro PassThru, retorna um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemplo
-------------------------- Exemplo 1 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
Este exemplo move o objeto de contato do ponto de extremidade do aplicativo com o endereço SIP endpoint1@litwareinc.com para o pool de Registrador confiável TrustPoolA.litwareinc.com. Use este comando para atualizar um aplicativo do UCMA 2,0 para um aplicativo do Microsoft Unified Communications Managed API (UCMA) 3.0 após a coexistência.
-------------------------- Exemplo 2 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
Este exemplo move o objeto de contato do ponto de extremidade do aplicativo com o endereço SIP endpoint2@litwareinc.com para o pool de Registrador confiável TrustPoolA.litwareinc.com. Este exemplo é diferente do Exemplo 1, pois este comando inclui o parâmetro Force. Use este comando para uma migração local de um aplicativo do UCMA 2,0 ou para implantação direta de um aplicativo do UCMA 2,0 contra uma implantação pura do Lync Server 2010. Isso irá atualizar um objeto existente no Active Directory com os atributos necessários, de forma que o roteamento possa ocorrer pelo Registrador do Lync Server 2010.