Set-MailContact

  • Artículo

 

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

Última modificación del tema: 2011-01-26

Utilice el cmdlet Set-MailContact con el objeto de modificar un contacto existente que tenga el correo habilitado en el servicio de directorio de Active Directory.

Sintaxis

Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descripción detallada

El cmdlet Set-MailContact modifica un contacto existente con el correo habilitado en Active Directory especificando la identidad y los atributos del contacto que deben ser modificados.

Para ejecutar el cmdlet Set-MailContact, se debe delegar lo siguiente en la cuenta que se use:

  • Función Administrador de destinatarios de Exchange

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

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

El parámetro Identity toma uno de los siguientes valores:

  • ADObjectID

  • GUID

  • Nombre distintivo (DN)

  • Domain\SamAccountName

  • Nombre principal de usuario (UPN)

  • DN heredado

  • Dirección de correo electrónico

  • Alias de contacto

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

El parámetro AcceptMessagesOnlyFrom especifica los usuarios del buzón, los usuarios de correo y los contactos de correo que pueden enviar mensajes de correo electrónico a este contacto de correo. También puede especificar Microsoft Exchange como destinatario válido para este parámetro. Si configura un contacto de correo para que acepte mensajes sólo del destinatario Microsoft  Exchange, sólo recibirá mensajes generados por el sistema.

El parámetro AcceptMessagesOnlyFrom puede utilizar cualquiera de los valores siguientes para los remitentes válidos:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • Alias

  • DN de Exchange

  • Dirección de correo electrónico SMTP principal

De manera predeterminada, este parámetro está en blanco. Este valor predeterminado permite que el contacto de correo acepte mensajes de todos los remitentes.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

El parámetro AcceptMessagesOnlyFromDLMembers especifica los grupos de distribución cuyos miembros pueden enviar mensajes de correo electrónico a este contacto de correo. Puede utilizar uno de los siguientes valores para los grupos de distribución permitidos:

  • Nombre distintivo (DN)

  • Nombre canónico

  • GUID

  • Nombre

  • Nombre para mostrar

  • DN de Exchange heredado

  • Dirección de correo electrónico SMTP principal

De manera predeterminada, este parámetro está en blanco. Este valor predeterminado permite que el contacto de correo acepte mensajes de todos los remitentes.

Alias

Opcional

System.String

El parámetro Alias especifica el alias del contacto habilitado para correo. Un alias puede contener letras, números y los siguientes signos de puntuación y símbolos:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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 es necesario especificar un valor con el parámetro Confirm.

CreateDTMFMap

Opcional

System.Boolean

Este parámetro especifica un mapa de tono de marcado de frecuencia múltiple (DTMF) que se crea para el contacto.

CustomAttribute1

Opcional

System.String

El parámetro CustomAttribute1 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute10

Opcional

System.String

El parámetro CustomAttribute10 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute11

Opcional

System.String

El parámetro CustomAttribute11 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute12

Opcional

System.String

El parámetro CustomAttribute12 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute13

Opcional

System.String

El parámetro CustomAttribute13 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute14

Opcional

System.String

El parámetro CustomAttribute14 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute15

Opcional

System.String

El parámetro CustomAttribute15 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute2

Opcional

System.String

El parámetro CustomAttribute2 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute3

Opcional

System.String

El parámetro CustomAttribute3 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute4

Opcional

System.String

El parámetro CustomAttribute4 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute5

Opcional

System.String

El parámetro CustomAttribute5 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute6

Opcional

System.String

El parámetro CustomAttribute6 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute7

Opcional

System.String

El parámetro CustomAttribute7 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute8

Opcional

System.String

El parámetro CustomAttribute8 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

CustomAttribute9

Opcional

System.String

El parámetro CustomAttribute9 especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional.

DisplayName

Opcional

System.String

El parámetro DisplayName especifica el nombre para mostrar del usuario.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

EmailAddresses

Opcional

Microsoft.Exchange.Data.ProxyAddressCollection

El parámetro EmailAddresses puede utilizarse para especificar el alias del correo electrónico del contacto de correo. Pueden utilizarse todos los tipos válidos de dirección de correo electrónico de Microsoft Exchange 2007. Puede especificar distintos valores para el parámetro EmailAddresses como una lista delimitada por comas.

Importante

Exchange 2007 no valida que el formato de las direcciones personalizadas sea correcto. Asegúrese de que la dirección personalizada que especifique cumpla los requisitos de formato para ese tipo de dirección. Puesto que las direcciones X.400 se consideran direcciones personalizadas en Exchange 2007, tampoco se validan. Por lo tanto, debe escribir la sintaxis correcta al especificar una dirección X.400.

EmailAddressPolicyEnabled

Opcional

System.Boolean

El parámetro EmailAddressPolicyEnabled especifica si las direcciones de correo electrónico para el buzón se actualizarán automáticamente en función de las directivas de direcciones de correo electrónico definidas.

Extensions

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica uno o varios números de extensión para el contacto. Cuando se establece el parámetro, todos los números de extensión del plan de marcado deben ser únicos.

ExternalEmailAddress

Opcional

Microsoft.Exchange.Data.ProxyAddress

El parámetro ExternalEmailAddress especifica la dirección de correo electrónico externa del destinatario.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

El parámetro GrantSendOnBehalfTo especifica los nombres distintivos (DN) de los destinatarios que pueden enviar mensajes en nombre de este contacto.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

El parámetro HiddenFromAddressListsEnabled especifica si el contacto aparece en las listas de direcciones. Si el valor es $true, el contacto no aparece en la lista de direcciones. El valor predeterminado es $false.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:

  • No puede utilizar el parámetro DomainController. El comando utilizará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede utilizar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.MailContact

El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts en los que se debe pasar un objeto completo al comando.

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

  • 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.

MaxReceiveSize

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro MaxReceiveSize indica el tamaño máximo de los mensajes de correo electrónico que se pueden recibir, desde 1 kilobyte (KB) hasta 2.097.151 KB.

Si no se ha especificado un valor, el límite se establece en el valor máximo.

MaxRecipientPerMessage

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro MaxRecipientPerMessage especifica el número máximo de destinatarios para los mensajes de este contacto de correo.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro MaxSendSize indica el tamaño máximo de los mensajes de correo electrónico que se pueden enviar, desde 1 KB hasta 2.097.151 KB.

Si no se ha especificado un valor, el límite se establece en el valor máximo.

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:

  • Texto

  • 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:

  • Texto

  • 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.

Name

Opcional

System.String

El parámetro Name especifica el nombre del contacto habilitado para correo.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

El parámetro PrimarySmtpAddress especifica la dirección de correo electrónico SMTP principal.

RejectMessagesFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

El parámetro RejectMessagesFrom indica los emisores de los que deben rechazarse los mensajes.

RejectMessagesFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

El parámetro RejectMessagesFromDLMembers indica los miembros de la lista de distribución de los que deben rechazarse mensajes.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

El parámetro RequireSenderAuthenticationEnabled especifica si se deben aceptar únicamente los mensajes de destinatarios autenticados. El valor predeterminado es $false.

SecondaryAddress

Opcional

System.String

Este parámetro especifica la dirección secundaria que utiliza el contacto habilitado para mensajería unificada.

SecondaryDialPlan

Opcional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Este parámetro especifica el plan secundario de marcado de mensajería unificada que se debe utilizar. Este parámetro se proporciona para crear una dirección proxy secundaria.

SimpleDisplayName

Opcional

System.String

El parámetro SimpleDisplayName se utiliza para mostrar una descripción alternativa del objeto cuando se permite únicamente un juego limitado de caracteres que consta de los caracteres ASCII del 26 al 126, ambos incluidos.

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica si desea crear un mapa DTMF definido por el usuario para el contacto habilitado para mensajería unificada.

UseMapiRichTextFormat

Opcional

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

El parámetro UseMapiRichTextFormat especifica cómo se controlarán los mensajes en formato de texto enriquecido (RTF) MAPI para este contacto de correo. Establezca este parámetro como Nunca para convertir todos los mensajes enviados a este contacto a texto sin formato. Establezca este parámetro como Siempre para enviar siempre los mensajes a este contacto en RTF MAPI. Establezca este parámetro como UseDefaultSettings para decidir el formato en función de los valores configurados en el cliente MAPI que envía el mensaje.

UsePreferMessageFormat

Opcional

System.Boolean

El parámetro UsePreferMessageFormat especifica si los valores del formato del mensaje configurados para el contacto de correo invalidarán los valores globales configurados para el dominio remoto. Establezca este parámetro como $true para que los valores del formato del mensaje configurados para el contacto de correo invaliden los valores globales.

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.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

Este parámetro WindowsEmailAddress especifica la dirección de correo electrónico de Windows para este buzón. Exchange no utiliza esta dirección.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

En este ejemplo, el comando Set-MailContact se utiliza para establecer la dirección de correo electrónica externa de John People como john@contoso.com.

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"