Set-MailContact

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Set-MailContact para modificar os contatos de email existentes.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-MailContact
   [-Identity] <MailContactIdParameter>
   [-AcceptMessagesOnlyFrom <MultiValuedProperty>]
   [-AcceptMessagesOnlyFromDLMembers <MultiValuedProperty>]
   [-AcceptMessagesOnlyFromSendersOrMembers <MultiValuedProperty>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-BypassModerationFromSendersOrMembers <MultiValuedProperty>]
   [-Confirm]
   [-CreateDTMFMap <Boolean>]
   [-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 <Boolean>]
   [-ExtensionCustomAttribute1 <MultiValuedProperty>]
   [-ExtensionCustomAttribute2 <MultiValuedProperty>]
   [-ExtensionCustomAttribute3 <MultiValuedProperty>]
   [-ExtensionCustomAttribute4 <MultiValuedProperty>]
   [-ExtensionCustomAttribute5 <MultiValuedProperty>]
   [-ExternalEmailAddress <ProxyAddress>]
   [-ForceUpgrade]
   [-GrantSendOnBehalfTo <MultiValuedProperty>]
   [-HiddenFromAddressListsEnabled <Boolean>]
   [-IgnoreDefaultScope]
   [-MacAttachmentFormat <MacAttachmentFormat>]
   [-MailTip <String>]
   [-MailTipTranslations <MultiValuedProperty>]
   [-MaxReceiveSize <Unlimited>]
   [-MaxRecipientPerMessage <Unlimited>]
   [-MaxSendSize <Unlimited>]
   [-MessageBodyFormat <MessageBodyFormat>]
   [-MessageFormat <MessageFormat>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-Name <String>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RejectMessagesFrom <MultiValuedProperty>]
   [-RejectMessagesFromDLMembers <MultiValuedProperty>]
   [-RejectMessagesFromSendersOrMembers <MultiValuedProperty>]
   [-RemovePicture]
   [-RemoveSpokenName]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-SecondaryAddress <String>]
   [-SecondaryDialPlan <UMDialPlanIdParameter>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-SimpleDisplayName <String>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-UseMapiRichTextFormat <UseMapiRichTextFormat>]
   [-UsePreferMessageFormat <Boolean>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

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

Este exemplo define o endereço de email externo de John Rodman como john@contoso.com.

Parâmetros

-AcceptMessagesOnlyFrom

O parâmetro AcceptMessagesOnlyFrom especifica quem tem permissão para enviar mensagens para esse destinatário. Mensagens de outros remetentes são rejeitadas.

Os valores válidos para esse parâmetro são remetentes individuais em sua organização (caixas de correio, usuários de email e contatos de email). É possível usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários remetentes separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Sender1,Sender2,...SenderN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Sender1","Sender2",..."SenderN".

Para adicionar ou remover remetentes sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}.

Os remetentes especificados para esse parâmetro são automaticamente copiados para a propriedade AcceptMessagesOnlyFromSendersOrMembers. Portanto, você não pode usar os parâmetros AcceptMessagesOnlyFrom e AcceptMessagesOnlyFromSendersOrMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os remetentes.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AcceptMessagesOnlyFromDLMembers

O parâmetro AcceptMessagesOnlyFromDLMembers especifica quem tem permissão para enviar mensagens para esse destinatário. Mensagens de outros remetentes são rejeitadas.

Os valores válidos para esse parâmetro são grupos em sua organização (grupos de distribuição, grupos de segurança habilitados para email e grupos de distribuição dinâmica). Especificar um grupo significa que todos os membros do grupo podem enviar mensagens para esse destinatário. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários grupos separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Group1,Group2,...GroupN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Group1","Group2",..."GroupN".

Para adicionar ou remover grupos sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="Group1","Group2"...; Remove="Group3","Group4"...}.

Os grupos especificados para esse parâmetro são copiados automaticamente para a propriedade AcceptMessagesOnlyFromSendersOrMembers. Portanto, você não pode usar os parâmetros AcceptMessagesOnlyFromDLMembers e AcceptMessagesOnlyFromSendersOrMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os grupos.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AcceptMessagesOnlyFromSendersOrMembers

O parâmetro AcceptMessagesOnlyFromSendersOrMembers especifica quem tem permissão para enviar mensagens para esse destinatário. Mensagens de outros remetentes são rejeitadas.

Os valores válidos para esse parâmetro são remetentes individuais e grupos em sua organização. Remetentes individuais são caixas de correio, usuários de email e contatos de email. Os grupos são grupos de distribuição, grupos de segurança habilitados para email e grupos de distribuição dinâmicos. Especificar um grupo significa que todos os membros do grupo podem enviar mensagens para esse destinatário.

Para especificar remetentes para esse parâmetro, você pode usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários remetentes separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Sender1,Sender2,...SenderN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Sender1","Sender2",..."SenderN".

Para adicionar ou remover remetentes ou grupos individuais sem afetar outras entradas existentes, use os parâmetros AcceptMessagesOnlyFrom e AcceptMessageOnlyFromDLMembers.

Os remetentes e grupos individuais que você especifica para esse parâmetro são automaticamente copiados para as propriedades AcceptMessagesOnlyFrom e AcceptMessagesOnlyFromDLMembers, respectivamente. Portanto, você não pode usar o parâmetro AcceptMessagesOnlyFromSendersOrMembers e o parâmetro AcceptMessagesOnlyFrom ou AcceptMessagesOnlyFromDLMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os remetentes.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Alias

O parâmetro Alias especifica o alias do Exchange (também conhecido como apelido de email) para o destinatário. Esse valor identifica o destinatário como um objeto habilitado para email e não deve ser confundido com vários endereços de email para o mesmo destinatário (também conhecido como endereços de proxy). Um destinatário pode ter apenas um valor de Alias. O tamanho máximo é de 64 caracteres.

O valor do Alias pode conter letras, números e os seguintes caracteres:

  • !, #, %, *, +, -, /, =, ?, ^, _, e ~.
  • $, &, ', ', {, }e | precisam ser escapados (por exemplo -Alias what`'snew) ou todo o valor incluído em aspas individuais (por exemplo, -Alias 'what'snew'). O & caractere não tem suporte no valor do Alias para Azure AD Sincronização do Connect.
  • Os períodos (.) devem ser cercados por outros caracteres válidos (por exemplo, help.desk).
  • Caracteres unicode U+00A1 a U+00FF.

Quando você cria um destinatário sem especificar um endereço de email, o valor do Alias especificado é usado para gerar o endereço de email primário (alias@domain). Os caracteres Unicode com suporte são mapeados para os melhores caracteres de texto US-ASCII. Por exemplo, U+00F6 (ö) é alterado para oe no endereço de email primário.

Se você não usar o parâmetro Alias ao criar um destinatário, o valor de um parâmetro necessário diferente será usado para o valor da propriedade Alias:

  • Destinatários com contas de usuário (por exemplo, caixas de correio de usuário e usuários de email): o lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName é usado. Por exemplo, helpdesk@contoso.onmicrosoft.com resulta no valor helpdeskda propriedade Alias .
  • Destinatários sem contas de usuário (por exemplo, caixas de correio de sala, contatos de email e grupos de distribuição): o valor do parâmetro Name é usado. Os espaços são removidos e caracteres sem suporte são convertidos em pontos de interrogação (?).

Se você modificar o valor do Alias de um destinatário existente, o endereço de email primário será atualizado automaticamente somente em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é True para o destinatário).

O parâmetro Alias nunca gera ou atualiza o endereço de email primário de um contato de email ou de um usuário de email.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ArbitrationMailbox

Este parâmetro está disponível somente no Exchange local.

O parâmetro ArbitrationMailbox especifica a caixa de correio de arbitragem que é usada para gerenciar o processo de moderação desse destinatário. É possível usar qualquer valor que identifique a caixa de correio de arbitragem exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassModerationFromSendersOrMembers

O parâmetro BypassModerationFromSendersOrMembers especifica quem pode enviar mensagens para esse destinatário moderado sem a aprovação de um moderador. Os valores válidos para esse parâmetro são remetentes individuais e grupos em sua organização. Especificar um grupo significa que todos os membros do grupo podem enviar mensagens para esse destinatário sem a aprovação de um moderador.

Para especificar remetentes para esse parâmetro, você pode usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Para inserir vários remetentes e substituir quaisquer entradas existentes, use a seguinte sintaxe: Sender1,Sender2,...SenderN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Sender1","Sender2",..."SenderN".

Para adicionar ou remover um ou mais remetentes sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}.

Esse parâmetro só é significativo quando a moderação é habilitada para o destinatário. Por padrão, esse parâmetro está em branco ($null), o que significa que as mensagens de todos os remetentes diferentes dos moderadores designados são moderadas. Quando um moderador envia uma mensagem para esse destinatário, a mensagem não é moderada. Em outras palavras, você não precisa usar esse parâmetro para incluir os moderadores.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateDTMFMap

Este parâmetro está disponível somente no Exchange local.

O parâmetro CreateDTMFMap especifica se é necessário criar um mapa DTMF (dupla frequência múltipla) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de UM (Mensagens Unificadas). Os valores válidos são:

  • $true: um mapa DTMF é criado para o destinatário. Esse é o valor padrão.
  • $true: um mapa DTMF foi criado para o destinatário. Este é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CustomAttribute1

Esse parâmetro especifica um valor para a propriedade CustomAttribute1 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute10

Esse parâmetro especifica um valor para a propriedade CustomAttribute10 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute11

Esse parâmetro especifica um valor para a propriedade CustomAttribute11 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute12

Esse parâmetro especifica um valor para a propriedade CustomAttribute12 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute13

Esse parâmetro especifica um valor para a propriedade CustomAttribute13 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute14

Esse parâmetro especifica um valor para a propriedade CustomAttribute14 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute15

Esse parâmetro especifica um valor para a propriedade CustomAttribute15 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute2

Esse parâmetro especifica um valor para a propriedade CustomAttribute2 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute3

Esse parâmetro especifica um valor para a propriedade CustomAttribute3 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute4

Esse parâmetro especifica um valor para a propriedade CustomAttribute4 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute5

Esse parâmetro especifica um valor para a propriedade CustomAttribute5 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute6

Esse parâmetro especifica um valor para a propriedade CustomAttribute6 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute7

Esse parâmetro especifica um valor para a propriedade CustomAttribute7 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute8

Esse parâmetro especifica um valor para a propriedade CustomAttribute8 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute9

Esse parâmetro especifica um valor para a propriedade CustomAttribute9 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. O tamanho máximo é 1024 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DisplayName

O parâmetro DisplayName especifica o nome de exibição do contato de email. O nome de exibição está visível no Centro de administração do Exchange (EAC) e nas listas de endereços. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EmailAddresses

O parâmetro EmailAddresses especifica todos os endereços de email (endereços proxy) para o destinatário, incluindo o endereço SMTP primário. Em organizações locais do Exchange, o endereço SMTP primário e outros endereços proxy normalmente são definidos por políticas de endereço de email. No entanto, você pode usar esse parâmetro para configurar outros endereços proxy para o destinatário. Para obter mais informações, consulte Email políticas de endereço no Exchange Server.

A sintaxe válida para esse parâmetro é "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN". O valor opcional 'Type especifica o tipo de endereço de email. Exemplos de valores válidos incluem:

  • SMTP: o endereço SMTP primário. Você pode usar esse valor apenas uma vez em um comando.
  • SMTP: o endereço SMTP principal. Você pode usar esse valor apenas uma vez em um comando.
  • X400: endereços X.400 no Exchange local.
  • X500: endereços X.500 no Exchange local.

Se você não incluir um valor Type para um endereço de email, o valor smtp será assumido. Observe que o Exchange não valida a sintaxe de tipos de endereço personalizados (incluindo endereços X.400). Portanto, você precisa verificar se todos os endereços personalizados são formatados corretamente.

Se você não incluir um valor de para um endereço de email, será presumido o valor smtp. Observe que exExchangeNoVersion não valida a sintaxe de tipos de endereço personalizados (incluindo endereços X.400). Portanto, você precisa verificar se todos os endereços personalizados estão formatados corretamente.

  • Use o SMTP de valor de tipo no endereço.
  • O primeiro endereço de email quando você não usa nenhum valor type ou quando você usa vários valores de tipo smtp minúsculas.
  • Em vez disso, use o parâmetro PrimarySmtpAddress. Você não pode usar o parâmetro EmailAddresses e o parâmetro PrimarySmtpAddress no mesmo comando.

O parâmetro PrimarySmtpAddress atualiza o endereço de email primário e a propriedade WindowsEmailAddress para o mesmo valor.

Para substituir todos os endereços de email proxy existentes pelos valores especificados, use a seguinte sintaxe: "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN".

Para adicionar ou remover a especificação de endereços proxy sem afetar outros valores existentes, use a seguinte sintaxe: @{Add="Type:EmailAddress1","Type:EmailAddress2",...; Remove="Type:EmailAddress3","Type:EmailAddress4",...}.

Type:ProxyAddressCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-EmailAddressPolicyEnabled

Este parâmetro está disponível somente no Exchange local.

O parâmetro EmailAddressPolicyEnabled especifica se deve aplicar políticas de endereço de email a esse destinatário. Os valores válidos são:

  • $true: Email políticas de endereço são aplicadas a esse destinatário. Esse é o valor padrão.
  • $true: todas as políticas de endereço de email são aplicadas a esse destinatário. Este é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtensionCustomAttribute1

Esse parâmetro especifica um valor para a propriedade ExtensionCustomAttribute1 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. Você pode especificar até 1300 valores separados por vírgulas.

Para inserir vários valores que substituem quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Embora esta seja uma propriedade multivalued, o filtro "ExtensionCustomAttribute1 -eq 'Value'" retornará uma correspondência se a propriedade contiver o valor especificado.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute2

Esse parâmetro especifica um valor para a propriedade ExtensionCustomAttribute2 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. Você pode especificar até 1300 valores separados por vírgulas.

Para inserir vários valores que substituem quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Embora esta seja uma propriedade multivalued, o filtro "ExtensionCustomAttribute2 -eq 'Value'" retornará uma correspondência se a propriedade contiver o valor especificado.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute3

Esse parâmetro especifica um valor para a propriedade ExtensionCustomAttribute3 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. Você pode especificar até 1300 valores separados por vírgulas.

Para inserir vários valores que substituem quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Embora esta seja uma propriedade multivalued, o filtro "ExtensionCustomAttribute3 -eq 'Value'" retornará uma correspondência se a propriedade contiver o valor especificado.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute4

Esse parâmetro especifica um valor para a propriedade ExtensionCustomAttribute4 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. Você pode especificar até 1300 valores separados por vírgulas.

Para inserir vários valores que substituem quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Embora esta seja uma propriedade multivalued, o filtro "ExtensionCustomAttribute4 -eq 'Value'" retornará uma correspondência se a propriedade contiver o valor especificado.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute5

Esse parâmetro especifica um valor para a propriedade ExtensionCustomAttribute5 no destinatário. Você pode usar essa propriedade para armazenar informações personalizadas sobre o destinatário e identificar o destinatário em filtros. Você pode especificar até 1300 valores separados por vírgulas.

Para inserir vários valores que substituem quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Embora esta seja uma propriedade multivalued, o filtro "ExtensionCustomAttribute5 -eq 'Value'" retornará uma correspondência se a propriedade contiver o valor especificado.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExternalEmailAddress

O parâmetro ExternalEmailAddress especifica o endereço de email de destino do usuário de email ou contato de email. Por padrão, esse valor é usado como o endereço de email principal do usuário de email ou contato de email.

Em ambientes locais, você pode usar o parâmetro PrimarySMTPAddress para definir o endereço de email primário como um valor diferente. Por padrão, esse valor é usado como o endereço de email principal do contato de email ou do usuário do email.

Quando você usa o parâmetro ExternalEmailAddress para alterar o endereço de email externo, o endereço de email externo antigo não é mantido como um endereço proxy.

Type:ProxyAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ForceUpgrade

O comutador ForceUpgrade suprime a mensagem de confirmação que aparece se o objeto foi criado em uma versão anterior do Exchange. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-GrantSendOnBehalfTo

O parâmetro GrantSendOnBehalfTo especifica quem pode enviar em nome desse contato por email. Embora as mensagens enviadas em nome do contato de email mostrem claramente o remetente no campo De (<Sender> on behalf of <Mail contact>), as respostas a essas mensagens são entregues ao contato de email, não ao remetente.

O proprietário remetente especificado para esse parâmetro deve ser uma caixa de correio, um usuário de email ou um grupo de segurança habilitado para email (uma entidade de segurança habilitada para email que pode ter permissões atribuídas). É possível usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Por padrão, esse parâmetro está em branco, o que significa que ninguém mais tem permissão para enviar em nome desse contato por email.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HiddenFromAddressListsEnabled

O parâmetro HiddenFromAddressListsEnabled especifica se esse destinatário está visível nas listas de endereços. Os valores válidos são:

  • $true: o destinatário não está visível nas listas de endereços.
  • $false: o destinatário está visível em listas de endereços. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica o contato de email que você deseja modificar. É possível usar qualquer valor que identifique o contato de email com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID
Type:MailContactIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Este parâmetro está disponível somente no Exchange local.

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MacAttachmentFormat

O parâmetro MacAttachmentFormat especifica o formato de anexo do sistema operacional Apple Macintosh a ser usado para mensagens enviadas ao usuário de email ou de email. Os valores válidos são:

  • BinHex (esse é o valor padrão)
  • Uuencode
  • Applesingle
  • AppleDouble

Os parâmetros MacAttachmentFormat e MessageFormat são interdependentes:

  • MessageFormat é Texto: MacAttachmentFormat pode ser BinHex ou UuEncode.
  • MessageFormat é Mime: MacAttachmentFormat pode ser BinHex, AppleSingle ou AppleDouble.
Type:MacAttachmentFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTip

O parâmetro MailTip especifica o texto mailtip personalizado para este destinatário. O MailTip é mostrado para remetentes quando eles começam a elaborar uma mensagem de email para este destinatário. Se o valor contiver espaços, coloque-o entre aspas (").

O parâmetro MailTip especifica o texto Dica de Email personalizado para esse destinatário. A Dica de Email é mostrada aos remetentes quando eles começam a traçar uma mensagem de email para esse destinatário. Se o valor contiver espaços, coloque-o entre aspas (").

  • As marcas HTML serão adicionadas automaticamente ao texto. Por exemplo, se você inserir o texto: "Essa caixa de correio não é monitorada", o MailTip automaticamente se tornará: <html><body>This mailbox is not monitored</body></html>. Não há suporte para marcas HTML adicionais e o comprimento do MailTip não pode exceder 175 caracteres exibidos.
  • O texto é adicionado automaticamente à propriedade MailTipTranslations do destinatário como o valor padrão: default:<MailTip text>. Se você modificar o texto do MailTip, o valor padrão será atualizado automaticamente na propriedade MailTipTranslations e vice-versa.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTipTranslations

O parâmetro MailTipTranslations especifica idiomas adicionais para o texto mailtip personalizado definido pelo parâmetro MailTip. As marcas HTML são adicionadas automaticamente à tradução do MailTip, não há suporte para marcas HTML adicionais e o comprimento da tradução do MailTip não pode exceder 175 caracteres exibidos.

O parâmetro MailTipTranslations especifica idiomas adicionais para o texto Dica de Email personalizado que é definido pelo parâmetro MailTip. As marcas HTML são adicionadas automaticamente à tradução de Dica de Email. Marcas HTML adicionais não são permitidas e o comprimento da tradução de Dica de Email não pode exceder 175 caracteres exibidos.

@{Add="Culture1:Localized text 1","\Culture2:Localized text 2"...; Remove="Culture3:Localized text 3","Culture4:Localized text 4"...}.

CultureN é um código de cultura de duas letras ISO 639 válido associado ao idioma.

Por exemplo, suponha que esse destinatário tenha atualmente o texto MailTip: "Essa caixa de correio não é monitorada". Para adicionar a tradução em espanhol, use o seguinte valor para este parâmetro: @{Add="ES:Esta caja no se supervisa."}.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MaxReceiveSize

Este parâmetro está disponível somente no Exchange local.

O parâmetro MaxReceiveSize especifica o tamanho máximo de uma mensagem que pode ser enviada para o contato de email. Mensagens maiores do que o tamanho máximo serão rejeitadas.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)
  • KB (quilobytes)
  • MB (megabytes)
  • GB (gigabytes)

TB (terabytes)

Um valor válido é um número até 1,999999 gigabytes (2147483647 bytes) ou o valor unlimited. O valor padrão é unlimited.

O valor ilimitado indica que o tamanho máximo da mensagem de recebimento para o contato de email é controlado em outro lugar (por exemplo, limites de organização, servidor ou conector).

A codificação base64 aumenta o tamanho das mensagens em aproximadamente 33%, portanto, especifique um valor 33% maior que o tamanho máximo real da mensagem que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxRecipientPerMessage

Este parâmetro está disponível somente no Exchange local.

O parâmetro MaxRecipientPerMessage especifica o número máximo de destinatários permitidos em mensagens enviadas pelo contato por email.

Um valor válido é um inteiro até 2147483647 (Int32) ou o valor ilimitado. O valor padrão é unlimited.

O valor ilimitado indica que o número máximo de destinatários por mensagem para o contato de email é controlado em outros lugares (por exemplo, limites de organização, servidor ou conector).

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxSendSize

Este parâmetro está disponível somente no Exchange local.

O parâmetro MaxSendSize especifica o tamanho máximo de uma mensagem que pode ser enviada pelo contato por email.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)
  • KB (quilobytes)
  • MB (megabytes)
  • GB (gigabytes)

TB (terabytes)

Um valor válido é um número até 1,999999 gigabytes (2147483647 bytes) ou o valor unlimited. O valor padrão é unlimited.

O valor ilimitado indica que o tamanho máximo da mensagem de envio para o contato de email é controlado em outro lugar (por exemplo, limites de organização, servidor ou conector).

A codificação base64 aumenta o tamanho das mensagens em aproximadamente 33%, portanto, especifique um valor 33% maior que o tamanho máximo real da mensagem que você deseja impor. Por exemplo, o valor de 64 MB resulta em um tamanho máximo de mensagem de aproximadamente 48 MB.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageBodyFormat

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

  • Texto
  • Html
  • Html

Os parâmetros MessageFormat e MessageBodyFormat são interdependentes:

  • MessageFormat é Mime: MessageBodyFormat pode ser Texto, Html ou TextAndHtml.
  • MessageFormat é Texto: MessageBodyFormat só pode ser Texto.
Type:MessageBodyFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MessageFormat

O parâmetro MessageFormat especifica o formato de mensagem para mensagens enviadas ao usuário de email ou contato de email. Os valores válidos são:

  • Texto
  • Text

Os parâmetros MessageFormat e MessageBodyFormat são interdependentes:

  • MessageFormat é Mime: MessageBodyFormat pode ser Texto, Html ou TextAndHtml.
  • MessageFormat é Texto: MessageBodyFormat só pode ser Texto.

Por isso, se quiser alterar o parâmetro MessageFormat de Mime para Text, o parâmetro MessageBodyFormat também deve ser alterado para Text.

Type:MessageFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModeratedBy

O parâmetro ModeratedBy especifica um ou mais moderadores para esse destinatário. Um moderador aprova mensagens enviadas para o destinatário antes que as mensagens sejam entregues. Um moderador deve ser uma caixa de correio, um usuário de email ou um contato de email em sua organização. É possível usar qualquer valor que identifique o moderador exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Você precisa usar esse parâmetro para especificar pelo menos um moderador quando define o parâmetro ModerationEnabled para o valor $true.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModerationEnabled

O parâmetro ModerationEnabled especifica se a moderação está habilitada para esse destinatário. Os valores válidos são:

  • $true: a moderação está habilitada para esse destinatário. As mensagens enviadas a esse destinatário devem ser aprovadas por um moderador antes que as mensagens sejam entregues.
  • $false: A moderação está desabilitada para este destinatário. As mensagens enviadas a esse destinatário são entregues sem a aprovação de um moderador. Esse é o valor padrão.

Você usa o parâmetro ModeratedBy para especificar os moderadores.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

O parâmetro Name especifica o nome exclusivo do contato de email. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PrimarySmtpAddress

Este parâmetro está disponível somente no Exchange local.

O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário.

Por padrão, o endereço principal é o mesmo do parâmetro ExternalEmailAddress.

Se você definir o parâmetro EmailAddressPolicyEnabled como $false, poderá especificar o endereço primário usando o parâmetro PrimarySmtpAddress, mas os endereços de email do contato de email não serão atualizados automaticamente pelas políticas de endereço de email. Recomendamos que você não define o endereço de email principal para um valor diferente de ExternalEmailAddress a não ser que você esteja em um cenário entre florestas.

O parâmetro PrimarySmtpAddress atualiza o endereço de email primário e a propriedade WindowsEmailAddress para o mesmo valor.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RejectMessagesFrom

O parâmetro RejectMessagesFrom especifica quem não tem permissão para enviar mensagens para esse destinatário. As mensagens desses remetentes são rejeitadas.

Os valores válidos para esse parâmetro são remetentes individuais em sua organização (caixas de correio, usuários de email e contatos de email). É possível usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários remetentes separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Sender1,Sender2,...SenderN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Sender1","Sender2",..."SenderN".

Para adicionar ou remover remetentes sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}.

Os remetentes especificados para esse parâmetro são automaticamente copiados para a propriedade RejectMessagesFromSendersOrMembers. Portanto, você não pode usar os parâmetros RejectMessagesFrom e RejectMessagesFromSendersOrMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os remetentes.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RejectMessagesFromDLMembers

O parâmetro RejectMessagesFromDLMembers especifica quem não tem permissão para enviar mensagens para esse destinatário. As mensagens desses remetentes são rejeitadas.

Os valores válidos para esse parâmetro são grupos em sua organização (grupos de distribuição, grupos de segurança habilitados para email e grupos de distribuição dinâmica). Especificar um grupo significa que todos os membros do grupo não podem enviar mensagens para esse destinatário. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários grupos separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Group1,Group2,...GroupN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Group1","Group2",..."GroupN".

Para adicionar ou remover grupos sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="Group1","Group2"...; Remove="Group3","Group4"...}.

Os grupos especificados para esse parâmetro são automaticamente copiados para a propriedade RejectMessagesFromSendersOrMembers. Portanto, você não pode usar os parâmetros RejectMessagesFromDLMembers e RejectMessagesFromSendersOrMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os grupos.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RejectMessagesFromSendersOrMembers

O parâmetro RejectMessagesFromSendersOrMembers especifica quem não tem permissão para enviar mensagens para esse destinatário. As mensagens desses remetentes são rejeitadas.

Os valores válidos para esse parâmetro são remetentes individuais e grupos em sua organização. Remetentes individuais são caixas de correio, usuários de email e contatos de email. Os grupos são grupos de distribuição, grupos de segurança habilitados para email e grupos de distribuição dinâmicos. Especificar um grupo significa que todos os membros do grupo não podem enviar mensagens para esse destinatário.

Para especificar remetentes para esse parâmetro, você pode usar qualquer valor que identifique exclusivamente o remetente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Você pode inserir vários remetentes separados por vírgulas. Para substituir todas as entradas existentes, use a seguinte sintaxe: Sender1,Sender2,...SenderN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Sender1","Sender2",..."SenderN".

Para adicionar ou remover remetentes ou grupos individuais sem afetar outras entradas existentes, use os parâmetros RejectMessagesFrom e RejectMessagesFromDLMembers.

Os remetentes e grupos individuais que você especifica para esse parâmetro são automaticamente copiados para as propriedades RejectMessagesFrom e RejectMessagesFromDLMembers, respectivamente. Portanto, você não pode usar o parâmetro RejectMessagesFromSendersOrMembers e os parâmetros RejectMessagesFrom ou RejectMessagesFromDLMembers no mesmo comando.

Por padrão, esse parâmetro está em branco ($null), o que permite que esse destinatário aceite mensagens de todos os remetentes.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemovePicture

Este parâmetro está disponível somente no Exchange local.

O comutador RemovePicture remove a imagem do contato de email. Não é preciso especificar um valor com essa opção.

Você pode adicionar uma imagem a um contato por email usando o cmdlet Import-RecipientDataProperty.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RemoveSpokenName

Este parâmetro está disponível somente no Exchange local.

O comutador RemoveSpokenName remove o nome falado do contato de email. Não é preciso especificar um valor com essa opção.

Você pode adicionar um arquivo de som a um contato de email usando o cmdlet Import-RecipientDataProperty.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RequireSenderAuthenticationEnabled

O parâmetro RequireSenderAuthenticationEnabled especifica se deve aceitar mensagens somente de remetentes autenticados (internos). Os valores válidos são:

  • $true: as mensagens são aceitas somente de remetentes autenticados (internos). Mensagens de remetentes não autenticados (externos) são rejeitadas.
  • $true: as mensagens são aceitas apenas de remetentes autenticados (internos). As mensagens de remetentes não autenticados (externos) são rejeitadas.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Online Protection

-SecondaryAddress

Este parâmetro está disponível somente no Exchange local.

O parâmetro SecondaryAddress especifica o endereço secundário usado pelo contato de email habilitado para UM (Mensagens Unificadas).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SecondaryDialPlan

Este parâmetro está disponível somente no Exchange local.

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

Type:UMDialPlanIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SendModerationNotifications

As conexões do cliente são feitas por proxy dos serviços de Acesso para Cliente para os serviços de back-end nos servidores de Caixa de Correio locais ou remotos. Os valores válidos são:

  • Sempre: notifique todos os remetentes quando as mensagens não forem aprovadas. Esse é o valor padrão.
  • Always: notificar todos os remetentes quando suas mensagens não forem aprovadas. Este é o valor padrão.
  • Internal: notificar remetentes da organização quando as mensagens não forem aprovadas.

Esse parâmetro só é significativo quando a moderação é habilitada (o parâmetro ModerationEnabled tem o valor $true).

Type:TransportModerationNotificationFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando apenas um conjunto limitado de caracteres é permitido. Os caracteres válidos são:

  • O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto, quando apenas um conjunto limitado de caracteres for permitido. Os caracteres válidos são:
  • a – z
  • A – Z
  • espaço
  • " ' ( ) + , - . / : ?
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMDtmfMap

Este parâmetro está disponível somente no Exchange local.

O parâmetro UMDtmfMap especifica os valores de mapa DTMF (dupla frequência múltipla) para o destinatário. Isso permite que o destinatário seja identificado usando um teclado telefônico em ambientes de UM (Mensagens Unificadas). Normalmente, esses valores DTMF são criados e atualizados automaticamente, mas você pode usar esse parâmetro para fazer alterações manualmente. Esse parâmetro aceita a seguinte sintaxe:

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

Para inserir valores que substituem todas as entradas existentes, use a seguinte sintaxe: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>.

Se você usar essa sintaxe e omitir qualquer um dos valores de mapa DTMF, esses valores serão removidos do destinatário. Por exemplo, se você especificar apenas emailAddress:<integers>, todos os valores existentes lastNameFirstName e firstNameLastName serão removidos.

Para adicionar ou remover valores sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}.

Se você usar essa sintaxe, não precisará especificar todos os valores do mapa DTMF e especificar vários valores de mapa DTMF. Por exemplo, você pode usar @{Add="emailAddress:<integers1>","emailAddress:<integers2>} para adicionar dois novos valores para emailAddress sem afetar os valores lastNameFirstName e firstNameLastName existentes.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UseMapiRichTextFormat

O parâmetro UseMapiRichTextFormat especifica o que fazer com mensagens enviadas para o usuário de email ou contato de email no formato de texto avançado MAPI, também conhecido como Texto Rico do Outlook ou Formato de Encapsulamento Neutro de Transporte (TNEF). Os valores válidos são:

  • Sempre: o TNEF é usado para todas as mensagens enviadas ao usuário de email ou ao contato por email.
  • Nunca: o TNEF nunca é usado para mensagens enviadas ao usuário de email ou ao contato por email. As mensagens TNEF são convertidas em texto sem formatação.
  • UseDefaultSettings: as mensagens TNEF não são especificamente permitidas ou impedidas para o usuário de email ou contato de email. Se as mensagens TNEF são enviadas para o destinatário depende das configurações de TNEF de domínio remoto (o domínio remoto padrão ou um domínio remoto específico) ou das configurações de mensagem de Texto Rico do Outlook especificadas pelo remetente no Outlook.

O valor padrão é UseDefaultSettings.

Type:UseMapiRichTextFormat
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UsePreferMessageFormat

O UsePreferMessageFormat especifica se as configurações de formato de mensagem configuradas para o usuário de email ou o contato de email substituem as configurações globais configuradas para o domínio remoto ou configuradas pelo remetente de mensagens. Os valores válidos são:

  • $true: as mensagens enviadas ao usuário de email ou ao contato por email usam o formato de mensagem configurado para o usuário de email ou contato de email.
  • $false: as mensagens enviadas ao usuário de email ou ao contato por email usam o formato de mensagem configurado para o domínio remoto (o domínio remoto padrão ou um domínio remoto específico) ou configurado pelo remetente de mensagens. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows para este destinatário. Esse é um atributo comum do Active Directory que está presente em todos os ambientes, incluindo ambientes sem Exchange. Usar o parâmetro WindowsEmailAddress em um destinatário tem um dos seguintes resultados:

  • Em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor True para o destinatário), o parâmetro WindowsEmailAddress não tem efeito na propriedade WindowsEmailAddress ou no valor do endereço de email primário.
  • Em ambientes em que o destinatário não está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor False para o destinatário), o parâmetro WindowsEmailAddress atualiza a propriedade WindowsEmailAddress e o endereço de email primário para o mesmo valor.

A propriedade WindowsEmailAddress é visível para o destinatário em Usuários e Computadores do Active Directory no atributo E-mail. O nome comum do atributo é E-mail-Addresses e o Ldap-Display-Name é email. Se você modificar esse atributo no Active Directory, o endereço de email principal do destinatário não será atualizado para o mesmo valor.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.