Update-Recipient

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-07-18

Use o cmdlet Update-Recipient para adicionar atributos do Microsoft Exchange Server 2007 a objetos de destinatário criados pelo agente de gerenciamento de sincronização da GAL (lista de endereços global) no ILM (Identity Lifecycle Manager) 2007. Os objetos de destinatário que você modificar usando este cmdlet devem residir em um servidor do Exchange 2007.

Sintaxe

Update-Recipient -Identity <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Devido a fusões e aquisições ou requisitos legais, os clientes podem ter necessidade de implantar o Exchange em uma topologia de várias florestas do Exchange. Tais implantações exigem a sincronização de objetos de destinatário em florestas de serviço de diretório do Active Directory distintas. Para saber mais sobre topologias de várias florestas do Exchange, consulte Planejando uma organização complexa do Exchange.

A Microsoft fornece o agente de gerenciamento de sincronização da GAL para sincronizar objetos de destinatário. A versão do agente de gerenciamento de sincronização da GAL que foi incluída no Microsoft Identity Integration Server (MIIS) 2003 foi projetada para trabalhar com o Exchange Server 2003 e baseia-se no RUS (Serviço de Atualização de Destinatário). Devido ao RUS ser um recurso substituído e não mais necessário para o Exchange 2007, o novo agente de gerenciamento de sincronizaçao da GAL incluído no ILM 2007 é projetado para funcionar sem o RUS.

Como parte do processo de sincronização, o agente de gerenciamento de sincronização da GAL do ILM 2007 cria objetos de destinatário em ambas as florestas do Active Directory. Depois que os destinatários são criados, o agente de gerenciamento usa o cmdlet Update-Recipient para adicionar os atributos exigidos pelo Exchange 2007 para concluir a configuração de tais destinatários.

Dica

Se você estiver usando o MIIS 2003, será necessário executar vários cmdlets para concluir o processo de configuração dos contatos de email criados pelo agente de gerenciamento de sincronização da GAL. Para obter informações detalhadas sobre a configuração de contatos de email criados pelo MIIS 2003, consulte Como implantar o Exchange 2007 em uma topologia entre florestas. O cmdlet Update-Recipient fornece um método alternativo e mais eficiente de executar esta tarefa. Você pode simplesmente executar o cmdlet Update-Recipient nos objetos de destinatário criados pelo agente de gerenciamento de sincronização da GAL do MIIS 2003 para concluir seu processo de configuração.

Para executar o cmdlet Update-Recipient, você deve usar a conta à qual esteja delegado o seguinte:

  • Função Administrador de Destinatários do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro Identity identifica o destinatário. Você pode usar um dos seguintes valores:

  • GUID

  • Domínio\Conta

  • Nome UPN

  • LegacyExchangeDN

  • Endereço SMTP

  • Name

  • Alias

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

Credential

Opcional

System.Management.Automation.PSCredential

O parâmetro Credential especifica o nome de usuário e a senha a serem usados para acessar o Active Directory.

Se o parâmetro Credential for usado, o comando solicitará a senha da conta antes de continuar.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Serverespecifica o servidor no qual executar as operações selecionadas.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exemplo

O primeiro exemplo mostra como usar o cmdlet Update-Recipient para adicionar atributos do Exchange 2007 ao contato de email que representa a caixa de correio de Paulo Silva.

O segundo exemplo mostra como atualizar todos os contatos em uma UO (unidade organizacional) específica. Este exemplo assume que os destinatários estão sincronizados entre duas florestas, contoso.com e fabrikam.com, e que todos os destinatários sincronizados do domínio fabrikam.com estão armazenados em uma UO específica chamada Usuários de fabrikam.com no domínio contoso.com.

Update-Recipient -Identity "John Smith"
Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" | Update-Recipient