Set-MailUser

  • Artigo

 

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

Tópico modificado em: 2010-10-21

Use o cmdlet Set-MailUser para modificar os atributos relacionados a email de um usuário existente no serviço de diretório do Active Directory.

Sintaxe

set-MailUser -Identity <MailUserIdParameter> [-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>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Use o cmdlet Set-MailUser para modificar os atributos relacionados a email de um usuário habilitado para email no Active Directory.

Para executar o cmdlet Set-MailUser, você deve usar uma conta a 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.

Dica

Nem todos os atributos de usuário podem ser modificados pelo cmdlet Set-MailUser. Você pode definir outros atributos do usuário que não sejam relacionados a mensagens com o cmdlet Set-User.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

O parâmetro Identity adota um dos seguintes valores:

  • ADObjectID

  • GUID

  • Nome distinto (DN)

  • Domain\SamAccountName

  • Nome UPN

  • DN Herdado

  • Endereço de email

  • Alias do usuário

  • O parâmetro Identity não poderá ser usado se o parâmetro Instance estiver especificado.

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFrom especifica os usuários da caixa de correio, os usuários de email e os contatos de email que podem enviar mensagens de email para esse usuário de email. Também é possível especificar o Microsoft Exchange como um destinatário válido para esse parâmetro. Se você configurar um usuário de email para aceitar mensagens somente do destinatário do Microsoft Exchange, ele receberá somente 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. Este valor padrão permite que o usuário 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 tenham permissão para enviar mensagens de email a esse usuário 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. Este valor padrão permite que o usuário de email aceite mensagens de todos os remetentes.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias do usuário. 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 usuário.

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 pode ser usado para especificar o alias de email do usuário de email. 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. Quando esse parâmetro é definido como $true, você não pode alterar os parâmetros PrimarySmtpAddress ou WindowsEmailAddress.

Extensions

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica um ou mais números de ramal para o usuário. 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 um endereço de email fora da organização. As mensagens de email enviadas ao usuário são enviadas a esse endereço externo.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro GrantSendOnBehalfTo especifica o nome distinto (DN) dos destinatários que podem enviar mensagens em nome deste usuário.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

O parâmetro HiddenFromAddressListsEnabled especifica se o usuário aparece na lista de endereços. 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.MailUser

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 em mensagens enviadas para o usuário do 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 podem ser recebidas pelo usuário, de 1 quilobyte (KB) até 2.097.151 KB.

Se ele não for especificado, não haverá restrições de tamanho.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxSendSize especifica o tamanho máximo de mensagens de email que podem ser enviadas pelo usuário, de 1 KB até 2.097.151 KB.

Se ele não for especificado, não haverá restrições de tamanho.

MessageBodyFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

O parâmetro MessageBodyFormat especifica o formato de corpo da mensagem para mensagens enviadas ao usuário 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 das mensagens enviadas ao usuário 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 usuário.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

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

RecipientLimits

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro RecipientLimits especifica o número máximo de destinatários por mensagens deste usuário.

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.

SamAccountName

Opcional

System.String

O parâmetro SamAccountName define o nome de logon usado para oferecer suporte a clientes e servidores que executam versões antigas do sistema operacional, como Microsoft Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. Esse atributo deve conter menos de 20 caracteres. Um nome de conta pode conter letras, números e os seguintes sinais de pontuação e símbolos:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

SecondaryAddress

Opcional

System.String

Esse parâmetro especifica o endereço secundário usado pelo usuário 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 nos seguintes caracteres:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica se você deseja criar um mapa de DTMF definido pelo usuário para o usuário 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 por este usuário de email. Defina esse parâmetro como Never para converter todas as mensagens enviadas a este usuário em texto sem formatação. Defina esse parâmetro como Always para sempre enviar mensagens a este usuário 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 as definições de formato da mensagem configuradas para o usuário de email substituirão as definições globais configuradas para o domínio remoto. Especifique esse parâmetro como $true para que as definições de formato da mensagem configuradas para o usuário de email substituam todas as definições globais.

UserPrincipalName

Opcional

System.String

O parâmetro UserPrincipalName especifica um nome UPN para o usuário.

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

Nesse exemplo, o comando Set-MailUser é usado para definir o endereço de email externo da organização para o qual o email de John Peoples do usuário habilitado para mensagens é enviado.

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com