Enable-MailContact

 

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

Tópico modificado em: 2010-03-30

É possível usar o comando Enable-MailContact para habilitar um contato existente para email no Active Directory.

Sintaxe

Enable-MailContact -Identity <ContactIdParameter> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-PrimarySmtpAddress <SmtpAddress>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Esse comando habilita um contato existente para email no Active Directory adicionando os atributos exigidos pelo Microsoft Exchange Server 2007. Para habilitar um contato para email são necessários a identidade, o alias associado e o email de destino do contato.

Para executar o cmdlet Enable-MailContact, você deve representar a seguinte função na conta utilizada:

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

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

Parâmetros

Parâmetro	Necessário(s)	Tipo	Descrição
ExternalEmailAddress	Necessário(s)	Microsoft.Exchange.Data.ProxyAddress	Esse parâmetro especifica o email de destino. Por padrão, o endereço de email especificado no parâmetro ExternalEmailAddress é definido como PrimarySMTPAddress.
Identity	Necessário(s)	Microsoft.Exchange.Configuration.Tasks.ContactIdParameter	Esse parâmetro usa um dos seguintes valores: ADObjectID GUID nome distinto Domain\SamAccountName nome UPN LegacyExchangeDN Endereço de email Alias do contato
Alias	Opcional	System.String	Esse parâmetro especifica o alias do contato habilitado para email.
Confirm	Optional	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	Esse parâmetro especifica o nome para exibição do contato.
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.
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 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 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.
PrimarySmtpAddress	Optional	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 o parâmetro ExternalEmailAddress, 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.
UsePreferMessageFormat	Opcional	System.Boolean	Quando definido como verdadeiro, este parâmetro especifica se as configurações de formatos de mensagens preferidas pelo remetente substituirão as configurações globais para os emails enviados a esse usuário.
UseRusServer	Optional	System.String	Observação: Esse parâmetro está disponível somente no Exchange 2007 SP2. O parâmetro UseRusServer instrui o comando a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário Active Directory. O serviço Lista de Endereços é um componente do serviço Assistente do Sistema Exchange. O serviço Lista de Endereços cria e mantém valores de atributo 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 na lista de endereços e endereços de email.
WhatIf	Optional	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 nenhum valor para o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

Neste exemplo, o comando Enable-MailContact é usado para habilitar um contato existente para email no Active Directory e fornecer ao contato o endereço de email externo "ted@tailspintoys.com".

Enable-MailContact -Identity Ted -ExternalEmailAddress "ted@tailspintoys.com"

Observe que o comando Enable-MailContact não pode criar um novo contato no Active Directory. Use o comando New-MailContact para criar um novo contato.