Set-MailContact

  • Artigo

 

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

Tópico modificado em: 2011-01-26

Use o cmdlet Set-MailContact para modificar um contato habilitado para email existente no serviço de diretório do Active Directory.

Sintaxe

Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

O cmdlet Set-MailContact modifica um contato habilitado para email existente no Active Directory especificando a identidade do contato e os atributos a serem modificados.

Para executar o cmdlet Set-MailContact, você deve usar uma 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

O parâmetro Identity adota um dos seguintes valores:

  • ADObjectID

  • GUID

  • Nome distinto (DN)

  • Domain\SamAccountName

  • Nome de usuário principal (UPN)

  • DN Herdado

  • Endereço de email

  • Alias do contato

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFrom especifica os usuários de caixa de correio, os usuários de email e os contatos de email que podem enviar mensagens de email para esse contato. Também é possível especificar o Microsoft Exchange como um destinatário válido para esse parâmetro. Se você configurar um contato de email para aceitar mensagens apenas do destinatário do Microsoft Exchange, ele só receberá as mensagens geradas pelo sistema.

O parâmetro AcceptMessagesOnlyFrom pode obter qualquer um dos seguintes valores para os remetentes válidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • Alias

  • DN do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Esse valor padrão permite que o contato de email aceite mensagens de todos os remetentes.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFromDLMembers especifica os grupos de distribuição cujos membros têm permissão para enviar mensagens de email a esse contato de email. Você pode usar qualquer um dos seguintes valores para os grupos de distribuição permitidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Esse valor padrão permite que o contato de email aceite mensagens de todos os remetentes.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias do contato habilitado para email. Um alias pode conter letras, números e os seguintes sinais de pontuação e símbolos:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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.

CreateDTMFMap

Opcional

System.Boolean

Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o contato.

CustomAttribute1

Opcional

System.String

O parâmetro CustomAttribute1 especifica os atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute10

Opcional

System.String

O parâmetro CustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute11

Opcional

System.String

O parâmetro CustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute12

Opcional

System.String

O parâmetro CustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute13

Opcional

System.String

O parâmetro CustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute14

Opcional

System.String

O parâmetro CustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute15

Opcional

System.String

O parâmetro CustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute2

Opcional

System.String

O parâmetro CustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute3

Opcional

System.String

O parâmetro CustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute4

Opcional

System.String

O parâmetro CustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute5

Opcional

System.String

O parâmetro CustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute6

Opcional

System.String

O parâmetro CustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute7

Opcional

System.String

O parâmetro CustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute8

Opcional

System.String

O parâmetro CustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute9

Opcional

System.String

O parâmetro CustomAttribute9 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome para exibição do usuário.

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.

EmailAddresses

Opcional

Microsoft.Exchange.Data.ProxyAddressCollection

O parâmetro EmailAddresses pode ser usado para especificar o alias de email do contato. Todos os tipos de endereço de email do Microsoft Exchange 2007 válidos podem ser usados. Você pode especificar vários valores para o parâmetro EmailAddresses, como uma lista delimitada por vírgulas.

Importante

O Exchange 2007 não valida endereços personalizados para a obtenção da formatação correta. Você deve verificar se o endereço personalizado especificado é compatível com os requisitos de formatação desse tipo de endereço. Como os endereços X.400 são considerados endereços personalizados no Exchange 2007, eles também não são validados. Portanto, você deve fornecer a sintaxe correta ao especificar um endereço X.400.

EmailAddressPolicyEnabled

Opcional

System.Boolean

O parâmetro EmailAddressPolicyEnabled especifica se os endereços de email da caixa de correio serão atualizados automaticamente com base nas diretivas de endereço de email definidas.

Extensions

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica um ou mais números de ramal para o contato. Quando o parâmetro estiver definido, todos os números de ramal dentro do plano de discagem devem ser exclusivos.

ExternalEmailAddress

Opcional

Microsoft.Exchange.Data.ProxyAddress

O parâmetro ExternalEmailAddress especifica o endereço de email externo do destinatário.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro GrantSendOnBehalfTo especifica os nomes distintos (DN) dos destinatários que podem enviar mensagens em nome deste contato.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

O parâmetro HiddenFromAddressListsEnabled especifica se o contato aparece nas listas de endereços. Se o valor for $true, o contato não aparece na lista de endereço. O valor padrão é $false.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.MailContact

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

MacAttachmentFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

O parâmetro MacAttachmentFormat especifica o formato de anexo do sistema operacional Apple Macintosh para mensagens enviadas para o contato de email. Os valores válidos para este parâmetro são:

  • BinHex

  • AppleSingle

  • AppleDouble

Por padrão, esse parâmetro é definido como BinHex.

Os valores aceitáveis para o parâmetro MacAttachmentFormat dependem do parâmetro MessageFormat. Se o parâmetro MessageFormat estiver definido como Text, voce poderá usar apenas os valores BinHex para esse parâmetro. Se o parâmetro MessageFormat estiver definido como Mime, você poderá usar apenas os valores BinHex, AppleSingle ou AppleDouble com esse parâmetro.

MaxReceiveSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxReceiveSize especifica o tamanho máximo de mensagens de email que pode ser recebido, de 1 quilobyte (KB) até 2.097.151 KB.

Se não houver um valor especificado, o limite será definido para o valor máximo.

MaxRecipientPerMessage

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxRecipientPerMessage especifica o número máximo de destinatários por mensagem deste contato de email.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxSendSize especifica o tamanho máximo de mensagens de email que pode ser enviado, de 1 quilobyte (KB) até 2.097.151 KB.

Se não houver um valor especificado, o limite será definido para o valor máximo.

MessageBodyFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

O parâmetro MessageBodyFormat especifica o formato do corpo da mensagem para mensagens enviadas para o contato de email. Os valores válidos para este parâmetro são:

  • Text

  • Html

  • TextAndHtml

Por padrão, esse parâmetro é definido como TextAndHtml.

Os parâmetros MessageFormat e MessageBodyFormat são interdependentes. Se o parâmetro MessageFormat for definido como Mime, o parâmetro MessageBodyFormat poderá ser definido como qualquer valor válido. Contudo, se o parâmetro MessageFormat for definido como Text, o parâmetro MessageBodyFormat poderá ser definido apenas como Text. Portanto, se você desejar definir esse parâmetro como Html ou TextAndHtml, também deverá definir o parâmetro MessageFormat como Mime.

MessageFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

O parâmetro MessageFormat especifica o formato da mensagem para mensagens enviadas para o contato de email.

Os valores válidos para este parâmetro são:

  • Text

  • Mime

Por padrão, esse parâmetro é definido como Mime.

Os parâmetros MessageFormat e MessageBodyFormat são interdependentes. Se o parâmetro MessageFormat for definido como Mime, o parâmetro MessageBodyFormat poderá ser definido como qualquer valor válido. Contudo, se o parâmetro MessageFormat for definido como Text, o parâmetro MessageBodyFormat poderá ser definido apenas como Text. Portanto, se você desejar alterar o parâmetro MessageFormat de Mime para Text, também deverá alterar o parâmetro MessageBodyFormat para Text.

Name

Opcional

System.String

O parâmetro Name especifica o nome do contato habilitado para email.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro PrimarySmtpAddress especifica o endereço de email SMTP principal.

RejectMessagesFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFrom especifica os destinatários dos quais rejeitar mensagens.

RejectMessagesFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFromDLMembers especifica os membros da lista de distribuição dos quais rejeitar mensagens.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

O parâmetro RequireSenderAuthenticationEnabled especifica se deve aceitar mensagens somente de destinatários autenticados. O valor padrão é $false.

SecondaryAddress

Opcional

System.String

Esse parâmetro especifica o endereço secundário usado pelo contato habilitado para UM.

SecondaryDialPlan

Opcional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Esse parâmetro especifica um plano de discagem de UM secundário a ser usado. Esse parâmetro é fornecido para criar um endereço de proxy secundário.

SimpleDisplayName

Opcional

System.String

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando somente um conjunto limitado de caracteres for permitido. Esse conjunto limitado de caracteres consiste em caracteres ASCII de 26 a 126, inclusive.

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica se você deseja criar um mapa de DTMF definido pelo usuário para o contato habilitado para UM. 

UseMapiRichTextFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

O parâmetro UseMapiRichTextFormat especifica como as mensagens no formato MAPI RTF (Rich Text Format) serão manipuladas para este contato de email. Defina este parâmetro como Nunca para converter todas as mensagens enviadas a este contato para texto simples. Defina este parâmetro como Sempre para sempre enviar mensagens a este contato em MAPI RTF. Defina esse parâmetro como UseDefaultSettings para que o formato seja decidido com base na definição configurada no cliente MAPI que enviou a mensagem.

UsePreferMessageFormat

Opcional

System.Boolean

O parâmetro UsePreferMessageFormat especifica se o formato de mensagem configurado para o contato de email substituirá as configurações globais do domínio remoto. Defina este parâmetro como $true para que o formato de mensagem configurado para o contato de email substitua todas as configurações globais.

UseRusServer

Opcional

System.String
noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando para usar o servidor de Caixa de Correio especificado em que o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente no serviço Atendedor do Sistema Exchange. Esse serviço cria e mantém valores de atributos específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação da lista de endereços e endereços de email.

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á exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows desta caixa de correio. Esse endereço não é usado pelo Exchange.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Neste exemplo, o comando Set-MailContact é usado para mover o endereço de email externo de John Peoples para john@contoso.com.

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"