New-MailContact

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-14

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

Sintaxis

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

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 operadores de cuentas para los contenedores Active Directory aplicables

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.

Alias

Opcional

System.String

Alias del contacto de correo.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No tiene que especificar un valor con el parámetro Confirm.

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 del 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 de 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.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

Use este parámetro para especificar la dirección SMTP principal del contacto de correo. De manera predeterminada, la dirección SMPT principal se genera en base a la directiva de direcciones de correo electrónico predeterminada. Si especifica una dirección SMTP principal mediante este parámetro, el cmdlet definirá el atributo EmailAddressPolicyEnabled del contacto de correo como $false, y las direcciones de correo electrónico de este contacto de correo no se actualizarán automáticamente basándose en las directivas de dirección de correo electrónico.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando se suministra un objeto existente a este parámetro, el comando usará 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 anula la configuración global del correo enviado a este usuario.

UseRusServer

Opcional

System.String
noteNota:
Este parámetro sólo está disponible en Exchange 2007 SP2.

El parámetro UseRusServer indica al comando que use el servidor de buzones especificado en el que se esté ejecutando el servicio Lista de direcciones para obtener y establecer los atributos del buzón y del usuario de Active Directory.

El servicio Lista de direcciones es un componente del servicio Operador de sistema de Exchange. El servicio Lista de direcciones crea y mantiene valores de atributo específicos de Exchange en Active Directory. El servicio Lista de direcciones se puede usar para actualizar objetos de destinatario de un dominio mediante el uso de información específica, como la pertenencia a una lista de direcciones y direcciones de correo electrónico.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

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"