Plantillas

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

Última modificación del tema: 2007-08-29

En este tema se explica cómo se pueden usar las plantillas del Shell de administración de Exchange para copiar la configuración de un objeto a otro.

En los ejemplos de este tema se explica cómo usar las plantillas al crear un nuevo buzón con los cmdlets New-Mailbox y Set-Mailbox. No obstante, se pueden usar plantillas con muchos cmdlets. Aunque los requisitos específicos para cada cmdlet pueden variar, las plantillas se usan de la misma forma para todos los cmdlets.

¿Por qué son útiles las plantillas?

En Microsoft Exchange Server 2007, puede utilizar el Shell de administración de Exchange para administrar objetos, como buzones, conectores de envío y directivas para las listas de direcciones de correo electrónico. Estos objetos pueden contener muchas propiedades que se pueden configurar. Las propiedades que un administrador puede configurar son, por ejemplo, las que determinan un atributo personalizado condicional en una directiva de listas de direcciones de correo electrónico, si un dominio remoto permite respuestas automáticas a Internet y si el enrutamiento DNS está habilitado en un conector de envío.

Si desea crear nuevos objetos basados en la configuración de un objeto que ya existe, puede utilizar plantillas. Cuando utilice una plantilla para crear un nuevo objeto, el Shell de administración de Exchange no puede clonar las propiedades necesarias que deben ser únicas. Por tanto, debe especificar las propiedades necesarias y las propiedades que deben ser únicas al crear un nuevo objeto.

Veamos cómo puede utilizar una plantilla y ahorrar tiempo cuando desea crear 100 buzones con la siguiente configuración personalizada:

Las propiedades que aparecen en esta tabla son ejemplos de propiedades que puede establecer en los buzones con el Shell de administración de Exchange. Cuando cree un buzón nuevo con el cmdlet New-Mailbox, no puede configurar estas propiedades. Para configurar las propiedades, debe utilizar el cmdlet Set-Mailbox. Sin plantillas tendría que crear cada buzón nuevo y, a continuación, configurar sus propiedades. Con plantillas puede crear un buzón y configurar sus propiedades con el cmdlet Set-Mailbox. A continuación, puede utilizar el primer buzón como plantilla y crear el resto de buzones con esta plantilla.

¿Cómo implementa el Shell de administración de Exchange las plantillas?

El Shell de administración de Exchange permite usar plantillas al admitir el parámetro TemplateInstance en muchos cmdlets que tienen los verbos New (Nuevo), Add (Agregar) y Enable (Habilitar). El parámetro TemplateInstance acepta un objeto del mismo tipo que el objeto que está intentando crear. Por ejemplo, si quiere crear un nuevo buzón mediante el cmdlet New-Mailbox, debe proporcionar un objeto de buzón al parámetro TemplateInstance. Para obtener más información acerca de los cmdlets, consulte Descripción de los cmdlets. Para obtener más información acerca de los objetos, consulte Datos estructurados.

Al ejecutar un cmdlet con el parámetro TemplateInstance, el cmdlet combina la configuración recuperada del objeto especificado en el parámetro TemplateInstance con los valores que especificó en los parámetros necesarios del cmdlet. Su configuración combinada se utiliza para crear el nuevo objeto. No puede configurar los valores en un parámetro necesario mediante el parámetro TemplateInstance.

Para utilizar un objeto como plantilla, primero debe crear el objeto y, a continuación, configurar sus propiedades. Después de que haya configurado el objeto, puede crear objetos adicionales si usa el objeto configurado anteriormente como plantilla. Por ejemplo, si quiere crear un nuevo buzón con la configuración que se muestra en la tabla de la sección anterior, primero debe crear el buzón con el cmdlet New-Mailbox y, a continuación, utilizar el cmdlet Set-Mailbox para configurar las propiedades del objeto de buzón como en el siguiente ejemplo:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
New-Mailbox -Name "Kim Akers" -Database "Mailbox Database" -UserPrincipalName kim@contoso.com -Password $Password
Set-Mailbox "Kim Akers" -RetainDeletedItemsFor 30.00:00:00 -ProhibitSendQuota 1GB -ProhibitSendReceiveQuota 1500MB -IssueWarningQuota 750MB -UseDatabaseQuotaDefaults $False -UseDatabaseRetentionDefaults $False

Para obtener más información acerca de cómo administrar buzones, consulte Administración de buzones de usuario.

Después de que haya creado y configurado el objeto de buzón que desea utilizar como plantilla, puede crear objetos de buzón adicionales con la misma configuración. Primero debe asignar el objeto de buzón que desea utilizar como plantilla a una variable, como en el siguiente ejemplo:

$Template = Get-Mailbox "Kim Akers"

El nombre de la variable es indiferente. Para obtener más información acerca de las variables, consulte Variables definidas por el usuario.

Después de haber seleccionado un objeto de buzón como plantilla, puede crear un nuevo buzón si usa esa plantilla, como en el siguiente ejemplo:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
New-Mailbox -Name "David Simpson" -Database "Mailbox Database" -UserPrincipalName david@contoso.com -Password $Password -TemplateInstance $Template

Después de haber creado el nuevo buzón, puede utilizar el siguiente comando para ver las propiedades del objeto de buzón que ha configurado mediante la plantilla y comprobar que se han establecido correctamente:

Get-Mailbox "David Simpson" | Format-List Name, ProhibitSendQuota, ProhibitSendReceiveQuota, IssueWarningQuota, UseDatabaseQuotaDefaults, UseDatabaseRetentionDefaults, RetainDeletedItemsFor

Name                         : David Simpson
ProhibitSendQuota            : 1GB
ProhibitSendReceiveQuota     : 1500MB
IssueWarningQuota            : 750MB
UseDatabaseQuotaDefaults     : False
UseDatabaseRetentionDefaults : False
RetainDeletedItemsFor        : 30.00:00:00

Para obtener más información acerca del cmdlet Format-List, consulte Trabajo con salidas de comandos.

Uso de plantillas para crear varios objetos

Las plantillas son muy útiles si quiere crear muchos objetos a la vez. Por ejemplo, es posible que desee crear buzones para cada usuario que aparezca en un archivo de valores separados por comas (CSV) y aplicar la misma configuración a todos los buzones nuevos. Mediante el cmdlet Import-CSV y el cmdlet ForEach, podrá leer los datos del archivo CSV y crear un buzón para cada usuario que aparezca en la lista del archivo. Por ejemplo, suponga que desea crear buzones nuevos para los usuarios del siguiente archivo CSV y aplicar las propiedades del objeto de buzón configuradas en el objeto de buzón de Kim Akers. El archivo CSV, Users.csv, contiene la siguiente información:

Name,UPN,MailboxDatabase
Adam Bar,adam@contoso.com,Sales
Mike Ray,mike@contoso.com,Sales
Angela Barbariol,angela@contoso.com,Marketing
Chris Barry,chris@contoso.com,Marketing
Sanjay Jacob,sanjay@contoso.com,Marketing

Asigne primero el objeto de buzón que contiene la configuración que desea utilizar con la plantilla, como en el siguiente ejemplo:

$Template = Get-Mailbox "Kim Akers"

A continuación, puede crear los buzones mediante los cmdlets Import-CSV y ForEach:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
Import-CSV C:\Users.CSV | ForEach { New-Mailbox -Name $_.Name -UserPrincipalName $_.UPN -Database $_.MailboxDatabase -Password $Password -Template $Template }

Para obtener más información acerca del cmdlet ForEach y acerca de cómo agregar varios destinatarios, consulte los siguientes temas:

• Uso del Shell de administración de Exchange para la administración masiva de destinatarios (en inglés)

• Canalización