New-MailUser
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2009-05-12
Utilice el cmdlet New-MailUser para crear un nuevo usuario con correo habilitado.
Sintaxis
New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-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>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet New-MailUser crea un nuevo usuario con correo habilitado en el servicio de directorio de Active Directory.
Para ejecutar el cmdlet New-MailUser, la cuenta que utilice debe tener delegada la siguiente función:
Función Administrador de destinatarios de Exchange
Función de operador de cuentas para los contenedores de Active Directory aplicables
Para obtener más información sobre los permisos, funciones de delegación y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Nota
No todos los atributos de usuario se pueden definir con el cmdlet New-MailUser. Puede realizar ajustes adicionales con el cmdlet Set-User.
Parámetros
| Parámetro | Necesario | Tipo | Descripción | ||
|---|---|---|---|---|---|
ExternalEmailAddress |
Necesario |
Microsoft.Exchange.Data.ProxyAddress |
El parámetro ExternalEmailAddress especifica una dirección de correo electrónico fuera de la organización. Los mensajes de correo electrónico enviados al usuario con correo habilitado se envían a esta dirección externa. |
||
Name |
Necesario |
System.String |
El parámetro Name especifica el nombre común (CN) del usuario con buzón habilitado. |
||
Password |
Necesario |
System.Security.SecureString |
El parámetro Password especifica la contraseña que utiliza el usuario de correo para asegurar su cuenta. |
||
UserPrincipalName |
Necesario |
System.String |
El parámetro UserPrincipalName define el nombre de un usuario de sistema en un formato de dirección de correo electrónico (por ejemplo: ted@contoso.com). |
||
Alias |
Opcional |
System.String |
El parámetro Alias especifica el alias del usuario. 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. |
||
DisplayName |
Opcional |
System.String |
El parámetro DisplayName especifica el nombre que aparecerá en Microsoft Outlook para el usuario de correo. |
||
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. |
||
FirstName |
Opcional |
System.String |
El parámetro FirstName especifica el nombre de pila del usuario del buzón. |
||
Initials |
Opcional |
System.String |
El parámetro Initials especifica las iniciales del usuario del correo. |
||
LastName |
Opcional |
System.String |
El parámetro LastName especifica el apellido del usuario del buzón. |
||
MacAttachmentFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
El parámetro MacAttachmentFormat especifica que los mensajes se envían al usuario de correo con el formato de datos adjuntos del sistema operativo de Apple Macintosh. Los valores válidos para este parámetro son:
De manera predeterminada, se establece como BinHex. Los parámetros aceptables para el parámetro MacAttachmentFormat dependen del parámetro MessageFormat. Si el parámetro MessageFormat se establece como Text, sólo puede utilizar valores BinHex o UUENCODE para este parámetro. Si el parámetro MessageFormat se establece como Mime, sólo puede utilizar valores BinHex, AppleSingle o AppleDouble para este parámetro. |
||
MessageBodyFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
El parámetro MessageFMessageBodyFormat especifica el formato del cuerpo del mensaje para mensajes que se envían al usuario. Los valores válidos para este parámetro son:
De manera predeterminada, 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 cuerpo del mensaje para mensajes que se envían al usuario. Los valores válidos para este parámetro son:
De manera predeterminada, se establece como Mime. Los parámetros MessageFormat y MessageBodyFormat son independientes. 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 |
El parámetro OrganizationalUnit especifica la unidad organizativa a la que se agrega el nuevo usuario (por ejemplo: redmond.contoso.com/contacts). |
||
PrimarySmtpAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
Utilice este parámetro para indicar la dirección SMTP principal para el usuario de correo. De manera predeterminada, la dirección SMPT principal se genera basada en la directiva de direcciones de correo electrónico predeterminada. Si especifica una dirección SMTP principal con este parámetro, el cmdlet establecerá el atributo EmailAddressPolicyEnabled del usuario a correo en |
||
ResetPasswordOnNextLogon |
Opcional |
System.Boolean |
Si el parámetro ResetPasswordOnNextLogon está definido en $true, el usuario tiene que cambiar la contraseña en el siguiente inicio de sesión. |
||
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:
|
||
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Al suministrar un objeto existente al parámetro TemplateInstance, el comando utilizará la configuración de ese objeto para crear un duplicado exacto del objeto en un servidor de destino o local. |
||
UsePreferMessageFormat |
Opcional |
System.Boolean |
El parámetro UsePreferMessageFormat especifica si las opciones de formato del mensaje configuradas para el buzón sustituirán a la configuración global configurada para el dominio. Defina este parámetro en $true para que las opciones de formato de mensajes configuradas para el buzón sustituyan a cualquier otra configuración global. |
||
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. |
.gif "note")
Nota:Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
El siguiente ejemplo consta de dos comandos.
En el primer comando, se crea una contraseña, $password, del tipo System.Security.SecureString. Cuando el comando se ejecuta, aparece la instrucción "Escriba la contraseña". La cadena que escribe el usuario se convierte en la nueva contraseña, $password.
El segundo comando crea un nuevo objeto de usuario habilitado para correo llamado Ted Bremer y asigna al objeto la nueva contraseña creada, a través del parámetro Password. Ted es un empleado de Tailspin Toys, pero debido a que trabaja estrechamente con los empleados de la empresa Contoso, le han concedido una dirección de correo electrónico en contoso.com. Ted no tiene un buzón en Exchange Server de Contoso. Los mensajes de correo electrónico enviados a la dirección de correo electrónico de Ted en contoso.com se envían a su dirección de correo electrónico externa, ted@tailspintoys.com.
$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com