Compartir a través de


New-MailContact (RTM)

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-05

Puede usar el comando New-MailContact para crear un contacto con correo habilitado nuevo.

Sintaxis

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>]

Descripción detallada

El comando New-MailContact crea un objeto de contacto de correo nuevo en el Microsoft Active Directory y, a continuación, habilita el correo del contacto de correo.

Para ejecutar el cmdlet New-MailContact, debe usar una cuenta en la que se delegue lo siguiente:

  • Función Administrador de destinatarios de Exchange

  • Función de operador de cuentas para los contenedores Active Directory correspondientes 

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

ExternalEmailAddress

Necesario

Microsoft.Exchange.Data.ProxyAddress

Dirección de correo electrónico de destino.

Name

Necesario

System.String

Nombre común del contacto de correo.

OrganizationalUnit

Necesario

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

La unidad organizativa a la que se agrega el nuevo contacto. Por ejemplo, redmond.contoso.com/contactos.

Alias

Opcional

System.String

Alias del contacto de correo.

DisplayName

Opcional

System.String

El nombre que aparecerá en Microsoft Outlook para el contacto de correo.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en Active Directory, incluya el parámetro DomainController en el comando.

FirstName

Opcional

System.String

Nombre del contacto de correo.

Initials

Opcional

System.String

Iniciales del contacto de correo.

LastName

Opcional

System.String

Apellidos del contacto de correo.

MacAttachmentFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

El parámetro MacAttachmentFormat especifica que los mensajes que se envían al contacto de correo tienen el formato de adjunto del sistema operativo Apple Macintosh. Los valores válidos para este parámetro son:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

De manera predeterminada, este parámetro se establece como BinHex.

Los valores válidos para el parámetro MacAttachmentFormat dependen del parámetro MessageFormat. Si el parámetro MessageFormat se establece como Text, sólo puede usar valores BinHex o UUENCODE para este parámetro. Si el parámetro MessageFormat se establece como Mime, sólo puede usar valores BinHex, AppleSingle o AppleDouble para este parámetro.

MessageBodyFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

El parámetro MessageBodyFormat especifica el cuerpo del mensaje de los mensajes que se envían al contacto de correo. Los valores válidos para este parámetro son:

  • Text

  • Html

  • TextAndHtml

De manera predeterminada, este parámetro se establece como TextAndHtml.

Los parámetros MessageFormat y MessageBodyFormat son interdependientes. Si el parámetro MessageFormat se establece en Mime, el parámetro MessageBodyFormat se puede establecer en cualquier valor válido. No obstante, si el parámetro MessageFormat se establece como Text, el parámetro MessageBodyFormat sólo se puede establecer como Text. Por lo tanto, si desea establecer este parámetro en Html o TextAndHtml, también debe establecer el parámetro MessageFormat en Mime.

MessageFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

El parámetro MessageFormat especifica el formato del mensaje para mensajes que se envían al contacto de correo.

Los valores válidos para este parámetro son:

  • Text

  • Mime

De manera predeterminada, este parámetro se establece como Mime.

Los parámetros MessageFormat y MessageBodyFormat son interdependientes. Si el parámetro MessageFormat se establece como Mime, el parámetro MessageBodyFormat se puede establecer como cualquier valor válido. No obstante, si el parámetro MessageFormat se establece como Text, el parámetro MessageBodyFormat sólo se puede establecer como Text. Por lo tanto, si desea cambiar el parámetro MessageFormat de Mime a Text, también debe cambiar el parámetro MessageBodyFormat a Text.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando se suministra un objeto existente a este parámetro, el comando utilizará la configuración de dicho objeto para crear un duplicado exacto del mismo en un servidor local o de destino.

UsePreferMessageFormat

Opcional

System.Boolean

Si se establece en true, este parámetro especifica que la configuración de formato de mensajes preferida por el destinatario invalida la configuración global del correo enviado a este usuario.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

Excepciones

Excepciones Descripción

Ejemplo

En el siguiente ejemplo, el comando New-MailContact se usa para crear un contacto con correo habilitado nuevo.

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