New-MailContact (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

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

Sintaxe

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

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 do 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.
OrganizationalUnit	Necessário	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	A unidade organizacional à qual o novo contato foi adicionado. Por exemplo, redmond.contoso.com/contacts.
Alias	Opcional	System.String	Alias do contato de email.
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.
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.

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"