New-Mailbox (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2008-03-13
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> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]
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 sobre 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 usar los siguientes valores:
|
Equipo |
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 cual reside la cuenta del usuario. El controlador de dominio en este bosque se usa 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 de dominio del bosque en el cual reside la cuenta del usuario. La cuenta principal es la cuenta a la que vincular el buzón. La cuenta maestra concederá acceso al buzón. Este parámetro es necesario sólo si está creando un buzón vinculado. Puede usar uno de los siguientes valores:
|
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. |
OrganizationalUnit |
Necesario |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
El parámetro OrganizationalUnit especifica el contenedor en el que se creará el 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á. |
Sala |
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. |
Compartido |
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 usa la directiva del buzón predeterminado. |
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. |
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 usará para escribir este cambio de configuración en Active Directory. Use el nombre de dominio completo (FQDN) del controlador de dominio que desee usar. |
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 usar 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 carpeta administrada que se 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. Al asignar una directiva de buzón de carpeta administrada a un buzón que use el parámetro ManagedFolderMailboxPolicy, la advertencia se muestra de manera 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. |
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. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
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