Set-MailContact (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
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>] [-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>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-WindowsEmailAddress <SmtpAddress>]
Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-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 usar una cuenta en la que se delegue lo siguiente:
- 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 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:
|
AcceptMessagesOnlyFrom |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFrom especifica los destinatarios que pueden enviar mensajes de correo electrónico a este contacto de correo. Se puede utilizar cualquiera de los siguientes valores para los remitentes válidos:
De manera predeterminada, este parámetro está en blanco. Este valor predeterminado habilita el contacto de correo para aceptar mensajes de todos los destinatarios. |
AcceptMessagesOnlyFromDLMembers |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFromDLMembers especifica los grupos de distribución habilitados para 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:
De manera predeterminada, este parámetro está en blanco. |
Alias |
Opcional |
System.String |
El parámetro Alias especifica el alias del contacto habilitado para correo. Los alias pueden contener letras, números y los siguientes signos de puntuación y símbolos:
|
CreateDTMFMap |
Opcional |
System.Boolean |
Este parámetro especifica un mapa de tono de marcado multifrecuencia (DTMF) que se crea para el contacto. |
CustomAttribute1 |
Opcional |
System.String |
El parámetro CustomAttribute1 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute10 |
Opcional |
System.String |
El parámetro CustomAttribute10 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute11 |
Opcional |
System.String |
El parámetro CustomAttribute11 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute12 |
Opcional |
System.String |
El parámetro CustomAttribute12 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute13 |
Opcional |
System.String |
El parámetro CustomAttribute13 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute14 |
Opcional |
System.String |
El parámetro CustomAttribute14 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute15 |
Opcional |
System.String |
El parámetro CustomAttribute15 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute2 |
Opcional |
System.String |
El parámetro CustomAttribute2 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute3 |
Opcional |
System.String |
El parámetro CustomAttribute3 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute4 |
Opcional |
System.String |
El parámetro CustomAttribute4 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute5 |
Opcional |
System.String |
El parámetro CustomAttribute5 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute6 |
Opcional |
System.String |
El parámetro CustomAttribute6 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute7 |
Opcional |
System.String |
El parámetro CustomAttribute7 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute8 |
Opcional |
System.String |
El parámetro CustomAttribute8 especifica atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. |
CustomAttribute9 |
Opcional |
System.String |
El parámetro CustomAttribute9 especifica 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 Active Directory, incluya el parámetro DomainController del comando. |
EmailAddresses |
Opcional |
Microsoft.Exchange.Data.ProxyAddressCollection |
El parámetro EmailAddresses especifica las direcciones de correo electrónico del proxy de la lista de distribución. |
EmailAddressPolicyEnabled |
Opcional |
System.Boolean |
El parámetro EmailAddressPolicyEnabled especifica si las direcciones de correo electrónico del 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 de llamadas 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.MailboxOrMailUserIdParameter[] |
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. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.MailContact |
El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts donde hay que 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:
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:
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 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 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:
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 sólo se deben aceptar 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 conmutación de llamadas 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 usa para mostrar una descripción alternativa del objeto cuando se permite únicamente un juego limitado de caracteres. Este juego limitado de caracteres 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. Este parámetro se puede establecer en UseDefaultSettings para que el formato se decida en función de la configuración del 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. |
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 usa 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"