Compartilhar via

Set-MailUser (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

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

set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-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 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 Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

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 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 destinatários que podem enviar mensagens de email para este usuário 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. Este valor padrão permite que o usuário de caixa de correio 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 usuário 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 usuário. 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 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 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. 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.MailboxOrMailUserIdParameter[]

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.

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

  • 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 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 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 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.

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