New-MailContact

  • Artigo

 

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

Tópico modificado em: 2009-05-14

Você pode usar o comando New-MailContact para criar um novo contato habilitado para email.

Sintaxe

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O comando New-MailContact cria um novo objeto de contato de email no Microsoft Active Directory e, em seguida, habilita o contato para email.

Para executar o cmdlet New-MailContact, você deve usar uma conta à qual estejam delegadas as seguintes funções:

  • Função Administrador de Destinatários do Exchange

  • Função de Operador de Conta para os contêineres Active Directory aplicáveis 

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

ExternalEmailAddress

Necessário

Microsoft.Exchange.Data.ProxyAddress

Endereço de email de destino.

Name

Necessário

System.String

Nome comum do contato de email.

Alias

Opcional

System.String

Alias do contato de email.

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.

DisplayName

Opcional

System.String

O parâmetro que será exibido em Microsoft Outlook para o contato de email.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

FirstName

Opcional

System.String

Nome do contato de email.

Initials

Opcional

System.String

Iniciais do contato de email.

LastName

Opcional

System.String

Sobrenome do contato de email.

MacAttachmentFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

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

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

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

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

MessageBodyFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

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

  • Text

  • Html

  • TextAndHtml

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

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

MessageFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

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

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

  • Text

  • Mime

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

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

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

A unidade organizacional à qual o novo contato foi adicionado. Por exemplo, redmond.contoso.com/contacts.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

Use esse parâmetro para especificar o endereço SMTP principal para o contato de email. Por padrão, o endereço SMTP primário é gerado com base na diretiva padrão de endereço de email. Se você especificar um endereço SMTP principal usando esse parâmetro, o cmdlet definirá o atributo EmailAddressPolicyEnabled do contato de email como $false e os endereços de email desse contato não serão atualizados automaticamente com base em diretivas de endereços de email.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para esse parâmetro, o comando usará a configuração desse objeto para criar uma duplicata exata do objeto em um servidor local ou de destino.

UsePreferMessageFormat

Opcional

System.Boolean

Quando definido como verdadeiro, esse parâmetro especifica que as configurações de formatos de mensagens preferidas do destinatário substituirão as configurações globais para email enviado para este 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.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

No exemplo a seguir, o comando New-MailContact é usado para criar um novo contato habilitado para email.

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"