Set-MailUser
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-10-21
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>] [-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>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | 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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-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, se debe delegar lo siguiente en la cuenta que 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.
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 usuarios del buzón, los usuarios de correo y los contactos de correo que pueden enviar mensajes de correo electrónico a este usuario de correo. También puede especificar Microsoft Exchange como destinatario válido para este parámetro. Si configura un usuario 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:
De manera predeterminada, este parámetro está en blanco. Este valor predeterminado permite que el usuario 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 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. Este valor predeterminado permite que el usuario de correo acepte mensajes de todos los remitentes. |
||
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:
|
||
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 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 puede utilizarse para especificar el alias del correo electrónico del usuario 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 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 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.RecipientIdParameter |
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. |
||
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:
|
||
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.Management.MailUser |
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 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 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 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. Los nombres de cuenta pueden 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 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. Este juego limitado de caracteres consta de los siguientes: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
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. Establezca este parámetro en Never para convertir en texto sin formato todos los mensajes enviados a este usuario. Establezca este parámetro 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. |
||
UseRusServer |
Opcional |
System.String |
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. |
.gif "note")
Nota: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