Modèles

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Dernière rubrique modifiée : 2007-08-29

Cette rubrique décrit l'utilisation de modèles dans l'environnement de ligne de commande Exchange Management Shell pour copier la configuration d'un objet vers un autre objet. 

Les exemples de cette rubrique décrivent l'utilisation de modèles lors de la création d'une boîte aux lettres à l'aide des cmdlets New-Mailbox et Set-Mailbox. Toutefois, vous pouvez utiliser des modèles avec de nombreuses cmdlets. Bien que les exigences spécifiques pour chaque cmdlet puissent varier, vous utilisez les modèles de la même manière pour toutes les cmdlets.

Utilité des modèles

Dans Microsoft Exchange Server 2007, l'environnement de ligne de commande Exchange Management Shell permet d'administrer des objets, tels que des boîtes aux lettres, des connecteurs d'envoi et des stratégies de liste d'adresses de messagerie. Ces objets peuvent contenir de nombreuses propriétés configurables. Des exemples de propriétés configurables par un administrateur sont celles qui déterminent un attribut personnalisé conditionnel sur une stratégie de liste d'adresses de messagerie, si un domaine distant permet des réponses automatiques à Internet, et si le routage DNS est activé sur un connecteur d'envoi.

Si vous créez des objets basés sur la configuration d'un objet existant, vous pouvez utiliser des modèles. Lorsque vous utilisez un modèle pour créer un objet, l'environnement de ligne de commande Exchange Management Shell ne peut pas copier des propriétés qui sont obligatoires et qui doivent être uniques. C'est pourquoi, vous devez spécifier les propriétés qui sont obligatoires et les propriétés qui doivent être uniques lors de la création de l'objet.

Voyons comment vous pouvez utiliser un modèle pour gagner du temps si vous voulez créer 100 boîtes aux lettres à l'aide de la configuration personnalisée suivante :

Les propriétés figurant dans ce tableau sont des exemples des propriétés que vous pouvez définir pour des boîtes aux lettres à l'aide de l'environnement de ligne de commande Exchange Management Shell. Lorsque vous créez une boîte aux lettres à l'aide de la cmdlet New-Mailbox, vous ne pouvez pas configurer ces propriétés. Pour configurer les propriétés, vous devez utiliser la cmdlet Set-Mailbox. À défaut de modèles, vous devriez créer chaque boîte aux lettres, puis configurer ses propriétés. Les modèles vous permettent de créer une boîte aux lettres et de configurer ses propriétés à l'aide de la cmdlet Set-Mailbox. Vous pouvez ensuite utiliser la première boîte aux lettres comme modèle, puis créer les autres boîtes aux lettres à l'aide de ce modèle.

Remarque :

Vous pouvez également utiliser une canalisation pour transférer le nouvel objet boîte aux lettres de la cmdlet New-Mailbox à la cmdlet Set-Mailbox. La cmdlet Set-Mailbox permet de définir les propriétés de la nouvelle boîte aux lettres. L'avantage lié à l'utilisation de modèles est que vous pouvez utiliser un objet existant configuré exactement comme vous le voulez pour configurer de nouveaux objets. En utilisant un objet existant, vous êtes certain de pouvoir maintenir une configuration cohérente pour tous ces objets. Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.

Comment l'environnement de ligne de commande Exchange Management Shell implémente-t-il des modèles ?

L'environnement de ligne de commande Exchange Management Shell permet d'utiliser des modèles en prenant en charge le paramètre TemplateInstance sur de nombreuses cmdlets contenant les mots New, Add et Enable. La paramètre TemplateInstance accepte un objet du même type que l'objet que vous tentez de créer. Par exemple, si vous voulez créer une boîte aux lettres à l'aide de la cmdlet New-Mailbox, vous devez fournir un objet boîte aux lettres au paramètre TemplateInstance. Pour plus d'informations sur les cmdlets, consultez la rubrique Présentation des cmdlets. Pour plus d'informations sur les objets, consultez la rubrique Données structurées.

Lorsque vous exécutez une cmdlet avec le paramètre TemplateInstance, la cmdlet combine la configuration extraite de l'objet spécifié dans le paramètre TemplateInstance avec les valeurs que vous spécifiez dans les paramètres obligatoires de la cmdlet. La configuration combinée permet de créer l'objet. Vous ne pouvez pas configurer les valeurs d'un paramètre obligatoire à l'aide du paramètre TemplateInstance.

Pour utiliser un objet comme modèle, vous devez créer l'objet, puis configurer ses propriétés. Une fois l'objet configuré, vous pouvez créer des objets supplémentaires à l'aide de cet objet précédemment configuré comme modèle. Par exemple, si vous voulez créer une boîte aux lettres avec la configuration indiquée dans le tableau de la section précédente, vous devez d'abord créer la boîte aux lettres avec la cmdlet New-Mailbox, puis utiliser la cmdlet Set-Mailbox pour configurer les propriétés de l'objet boîte aux lettres comme dans l'exemple suivant :

$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

Pour plus d'informations sur la gestion des boîtes aux lettres, consultez la rubrique Gestion des boîtes aux lettres d'utilisateurs.

Après avoir créé et configuré un objet boîte aux lettres à utiliser comme modèle, vous pouvez créer des objets boîte aux lettres supplémentaires avec la même configuration. Vous devez commencer par affecter l'objet boîte aux lettres que vous voulez utiliser comme modèle à une variable, comme dans l'exemple suivant :

$Template = Get-Mailbox "Kim Akers"

Le nom de la variable importe peu. Pour plus d'informations sur les variables, consultez la rubrique variables définies par l'utilisateur.

À présent que vous avez sélectionné un objet boîte aux lettres à utiliser comme modèle, vous pouvez créer une boîte aux lettres à l'aide de ce modèle, comme dans l'exemple suivant :

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

Après avoir créé la boîte aux lettres, vous pouvez utiliser la commande suivante pour afficher les propriétés de l'objet boîte aux lettres que vous avez configuré en utilisant le modèle pour vérifier qu'elles ont été correctement définies :

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

Pour plus d'informations sur la commande Format-List, consultez la rubrique Utilisation de la sortie d'une commande.

Utilisation de modèles pour créer plusieurs objets

Les modèles sont très utiles si vous voulez créer de nombreux objets en même temps. Par exemple, vous pouvez créer des boîtes aux lettres pour chaque utilisateur répertorié dans un fichier de valeurs séparées par des virgules (CSV), puis appliquer la même configuration à toutes les boîtes aux lettres. Les cmdlets Import-CSV et ForEach permettent de lire les données du fichier CSV, puis de créer une boîte aux lettres pour chaque utilisateur répertorié dans le fichier. Par exemple, supposons que vous vouliez créer des boîtes aux lettres pour les utilisateurs répertoriés dans le fichier CSV suivant, puis appliquer les propriétés de l'objet boîte aux lettres configurées sur l'objet boîte aux lettres Kim Akers. Le fichier CSV, Users.csv, contient les informations suivantes :

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

Commencez par affecter l'objet boîte aux lettres contenant la configuration que vous voulez utiliser pour le modèle, comme dans l'exemple suivant :

$Template = Get-Mailbox "Kim Akers"

Vous pouvez ensuite créer les boîtes aux lettres à l'aide des cmdlets Import-CSV et 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 }

Pour plus d'informations sur la cmdlet ForEach et la procédure d'ajout de plusieurs destinataires, consultez les rubriques suivantes :

• Utilisation d'Exchange Management Shell pour la gestion globales des destinataires

• Traitement en pipeline