Compartilhar via

Set-MailContact (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

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>] [-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>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-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 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

  • DN (nome distinto)

  • Domain\SamAccountName

  • Nome UPN

  • DN Herdado

  • Endereço de email

  • Alias do contato

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFrom especifica os destinatários que podem enviar mensagens de email para este contato de email. Qualquer um dos seguintes valores pode ser adotado para os remetentes válidos:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • 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 destinatários.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco.

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:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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 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 especifica os endereços de email do proxy da lista de distribuição.

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.MailboxOrMailUserIdParameter[]

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.

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

  • UUENCODE

  • 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, você poderá usar apenas os valores BinHex ou UUENCODE 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 do 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.

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"