New-Mailbox

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-12

Use el cmdlet New-Mailbox para crear un nuevo usuario en el servicio de directorio de Active Directory y habilitar para correo este nuevo usuario.

Sintaxis

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet New-Mailbox, la cuenta que use debe tener delegado lo siguiente:

• Función Administrador de destinatarios de Exchange

• Función Operador de cuentas para los contenedores de Active Directory correspondientes

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.

Parámetros

Parámetro	Necesario	Tipo	Descripción
Database	Necesario	Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter	El parámetro Database especifica la base de datos de Exchange que contendrá el nuevo buzón del usuario. Puede utilizar los siguientes valores: GUID de la base de datos Nombre de la base de datos Nombre del servidor\nombre de la base de datos Nombre del servidor\grupo de almacenamiento\nombre de la base de datos
Equipment	Necesario	System.Management.Automation.SwitchParameter	El parámetro Equipment especifica que el tipo de recurso es equipo, si este buzón es un buzón de recursos. Este parámetro es necesario sólo si está creando un buzón de recursos.
LinkedDomainController	Necesario	System.String	El parámetro LinkedDomainController especifica el controlador de dominio del bosque en el que reside la cuenta del usuario. El controlador de dominio en este bosque se utiliza para obtener información de seguridad para la cuenta especificada por el parámetro LinkedMasterAccount. Este parámetro es necesario sólo si está creando un buzón vinculado.
LinkedMasterAccount	Necesario	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	El parámetro LinkedMasterAccount especifica la cuenta maestra del bosque en el que reside la cuenta del usuario. La cuenta maestra es la cuenta a la que vincular el buzón. La cuenta maestra otorgará acceso al buzón. Este parámetro es necesario sólo si está creando un buzón vinculado. Puede utilizar cualquiera de los siguientes valores: GUID Nombre distintivo (DN) Dominio\Cuenta Nombre principal del usuario (UPN) LegacyExchangeDN SmtpAddress Alias
Name	Necesario	System.String	El parámetro Name especifica el nombre del usuario. Se trata del nombre que aparece en Usuarios y equipos de Active Directory. Se trata, asimismo, del nombre de usuario que aparece en Propiedades del destinatario en la ficha Información del usuario.
Password	Necesario	System.Security.SecureString	El parámetro Password especifica la contraseña inicial del usuario recién creado. Este parámetro no es necesario si está creando un buzón vinculado, buzón de recursos o buzón compartido, ya que la cuenta de usuario para estos tipos de buzones se deshabilitará.
Room	Necesario	System.Management.Automation.SwitchParameter	El parámetro Room especifica que el tipo de recurso es una sala, si este buzón es un buzón de recursos. Este parámetro es necesario sólo si está creando un buzón de recursos.
Shared	Necesario	System.Management.Automation.SwitchParameter	El parámetro Shared especifica que está creando un buzón compartido. Un buzón compartido es un buzón en el que se pueden registrar varios usuarios. Este buzón no se asocia con ninguno de los usuarios que pueden registrarse. Se asocia con una cuenta de usuario deshabilitada. Este parámetro es necesario sólo si está creando un buzón compartido.
UserPrincipalName	Necesario	System.String	El parámetro UserPrincipalName especifica el nombre principal del usuario (UPN) de este buzón. Se trata del nombre de inicio de sesión del usuario. EL UPN consta de un nombre de usuario y un sufijo. Normalmente, el sufijo es el nombre de dominio en el que reside la cuenta del usuario.
ActiveSyncMailboxPolicy	Opcional	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	El parámetro ActiveSyncMailboxPolicy especifica la directiva de buzón que se va a habilitar para el buzón que ha creado. Si no especifica este parámetro, se utilizará la directiva de buzón predeterminada.
Alias	Opcional	System.String	El parámetro Alias especifica el alias de correo electrónico del usuario que está creando. El alias puede ser una combinación de caracteres separados por un punto sin espacios intermedios. No utilice caracteres especiales en el alias.
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 para mostrar del nuevo usuario creado con este buzón. El DisplayName es el nombre que aparece en la Consola de administración de Exchange en Configuración de destinatarios. El DisplayName también aparece en Usuarios y equipos de Active Directory en la ficha Propiedades generales del usuario.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	El parámetro DomainController especifica el controlador de dominio que se va a utilizar para escribir este cambio de configuración en Active Directory. Use el nombre de dominio completo (FQDN) del controlador de dominio que desee utilizar.
FirstName	Opcional	System.String	El parámetro FirstName especifica el nombre del usuario que ha creado.
Initials	Opcional	System.String	El parámetro Initials especifica las iniciales del usuario que ha creado.
LastName	Opcional	System.String	El parámetro LastName especifica los apellidos del usuario que ha creado.
LinkedCredential	Opcional	System.Management.Automation.PSCredential	El parámetro LinkedCredential especifica las credenciales que se deben utilizar para tener acceso al controlador de dominio especificado por el parámetro LinkedDomainController. Este parámetro es opcional, incluso si está habilitando un buzón vinculado.
ManagedFolderMailboxPolicy	Opcional	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	El parámetro ManagedFolderMailboxPolicy especifica la directiva de buzón de la carpeta administrada que se va a habilitar para el buzón que ha creado.
ManagedFolderMailboxPolicyAllowed	Opcional	System.Management.Automation.SwitchParameter	El parámetro ManagedFolderMailboxPolicyAllowed omite la advertencia de que las funciones de administración de registros de mensajería no son compatibles con clientes de correo electrónico que utilizan versiones de Microsoft Outlook anteriores a Outlook 2007. Cuando se asigna una directiva de buzón de carpeta administrada a un buzón que utiliza el parámetro ManagedFolderMailboxPolicy, aparece la advertencia de forma predeterminada a menos que se use el parámetro ManagedFolderMailboxPolicyAllowed. Nota Se admiten los clientes de Outlook 2003 Service Pack 3, pero existen límites a sus funciones de administración de registros de mensajería.
OrganizationalUnit	Opcional	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	El parámetro OrganizationalUnit especifica el contenedor en el que se creará el usuario.
ResetPasswordOnNextLogon	Opcional	System.Boolean	Si está establecido en $true, el parámetro ResetPasswordOnNextLogon especifica que la contraseña del parámetro Password se debe reiniciar la próxima vez que el usuario inicie una sesión.
SamAccountName	Opcional	System.String	El parámetro SamAccountNameespecifica el nombre de inicio de sesión utilizado para admitir clientes y servidores que utilicen versiones anteriores del sistema operativo, tales como Microsoft Windows NT 4.0, Windows 95, Windows 98 y LAN Manager. Este atributo debe tener menos de 20 caracteres para ser compatible con clientes anteriores. Si no especifica este parámetro, Active Directory creará automáticamente un SAMAccountName, basado en el nombre principal del usuario.
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.
UseRusServer	Opcional	System.String	Nota: Este parámetro sólo está disponible en Exchange 2007 SP2. 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.

Tipos de entrada

Tipos de valores devueltos

Errores

Excepciones

Ejemplo

El primer ejemplo muestra cómo crear un usuario Chris Ashton en Active Directory y crear un buzón para el usuario. El buzón se ubica en el Grupo de almacenamiento 1, en la Base de datos de buzón 1. La contraseña debe restablecerse en el próximo inicio de sesión. Para establecer el valor inicial de la contraseña, este ejemplo crea una variable, $password, le pide que escriba una contraseña y asigna dicha contraseña a la variable como un objeto SecureString.

El segundo ejemplo muestra cómo crear un usuario en Active Directory y un buzón de recursos para una sala de conferencias. El buzón de recursos se ubica en el Grupo de almacenamiento 1, en la Base de datos de buzón 1. La contraseña debe restablecerse en el próximo inicio de sesión. El comando del Shell de administración de Exchange le pedirá el valor de la contraseña inicial, ya que no se ha especificado.

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true