Set-MailUser (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
Use el cmdlet Set-MailUser para modificar los atributos relacionados con el correo de un usuario existente del servicio de directorios de Active Directory.
Sintaxis
set-MailUser -Identity <MailUserIdParameter> [-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>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]
set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]
Descripción detallada
Use el cmdlet Set-MailUser para modificar los atributos relacionados con el correo de un usuario existente del servicio de directorios de Active Directory.
Para ejecutar el cmdlet Set-MailUser, debe utilizar 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.
Nota
Con el cmdlet Set-MailUser no se pueden modificar todos los atributos del usuario. Puede configurar otros atributos del usuario, no relacionados con el correo, mediante el cmdlet Set-User.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter |
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 usuario 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 permite que el usuario del buzón reciba mensajes de todos los destinatarios. |
AcceptMessagesOnlyFromDLMembers |
Opcional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
El parámetro AcceptMessagesOnlyFromDLMembers especifica los grupos de distribución que pueden enviar mensajes de correo electrónico a este usuario 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 usuario. 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 que se debe crear un mapa de tono de marcado multifrecuencia (DTMF) para el usuario. |
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. Si el parámetro se establece en $true, los parámetros PrimarySmtpAddress y WindowsEmailAddress no se pueden cambiar. |
Extensions |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica uno o varios números de extensión para el usuario. 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 una dirección de correo electrónico que se encuentra fuera de la organización. Los mensajes de correo electrónico enviados al usuario se envían a esta dirección externa. |
GrantSendOnBehalfTo |
Opcional |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[] |
El parámetro GrantSendOnBehalfTo especifica el nombre distintivo (DN) de los destinatarios que pueden enviar mensajes en nombre de este usuario. |
HiddenFromAddressListsEnabled |
Opcional |
System.Boolean |
El parámetro HiddenFromAddressListsEnabled indica si el usuario está en la lista de direcciones. El valor predeterminado es $false. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.MailUser |
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 el formato de datos adjuntos del sistema operativo Apple-Macintosh para los mensajes que se envían al usuario de correo. 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 puede recibir el usuario de correo; el valor puede oscilar entre 1 y 2.097.151 KB. Si no se especifica, no hay restricciones de tamaño. |
MaxSendSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro MaxSendSize indica el tamaño máximo de los mensajes de correo electrónico que puede enviar el usuario de correo; el valor puede oscilar entre 1 y 2.097.151 KB. Si no se especifica, no hay restricciones de tamaño. |
MessageBodyFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
El parámetro MessageBodyFormat especifica el formato de cuerpo del mensaje para mensajes que se envían al usuario 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 usuario 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 usuario. |
PrimarySmtpAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
El parámetro PrimarySmtpAddress especifica la dirección SMTP principal. |
RecipientLimits |
Opcional |
Microsoft.Exchange.Data.Unlimited |
El parámetro RecipientLimits especifica el número máximo de destinatarios de los mensajes de este usuario. |
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. |
SamAccountName |
Opcional |
System.String |
El parámetro SamAccountName especifica el nombre de inicio de sesión utilizado para admitir los clientes y servidores que ejecutan versiones anteriores del sistema operativo, tales como Microsoft Windows NT 4.0, Windows 98, Windows 95 y Administrador de LAN. Este atributo debe contener menos de 20 caracteres. Un nombre de cuenta puede contener letras, números y los siguientes signos de puntuación y símbolos:
|
SecondaryAddress |
Opcional |
System.String |
Este parámetro especifica la dirección secundaria que utiliza el usuario 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 usuario 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) de MAPI de este usuario. Este parámetro se puede establecer en Never para convertir a texto sin formato todos los mensajes enviados a este usuario. Este parámetro se puede establecer en Always para enviar los mensajes a este usuario siempre en formato RTF de 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 la configuración del formato de los mensajes del usuario de correo invalidará la configuración global del dominio remoto. Asigne a este parámetro el valor $true para que la configuración de formato de mensajes del usuario de correo invalide toda configuración global. |
UserPrincipalName |
Opcional |
System.String |
El parámetro UserPrincipalName especifica el nombre principal de usuario (UPN) del usuario. |
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, se usa el comando Set-MailUser para establecer la dirección de correo electrónico de fuera de la organización a la que se envía el correo electrónico del usuario John Peoples.
Set-MailUser john -ExternalEmailAddress john@tailspintoys.com