New-MailUser (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
Utilice el cmdlet New-MailUser para crear un nuevo usuario con correo habilitado.
Sintaxis
New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
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 Active Directory correspondientes
Para obtener más información sobre los permisos, la delegación de funciones 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 que se encuentra 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. |
OrganizationalUnit |
Necesario |
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). |
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. Los alias pueden contener letras, números y los siguientes signos de puntuación y símbolos:
|
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 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. |
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. |
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 utiliza la configuración de ese objeto para crear un duplicado exacto del objeto en un servidor local o de destino. |
UsePreferMessageFormat |
Opcional |
System.Boolean |
El parámetro UsePreferMessageFormat especifica si la configuración de formato del mensaje para el buzón invalidará la configuración global del dominio. Defina este parámetro en $true para que las opciones de formato de mensajes configuradas para el buzón invaliden cualquier otra configuración global. |
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 como 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