Vorlagen
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-08-29
In diesem Thema wird erläutert, wie Sie mithilfe von Vorlagen in der Exchange-Verwaltungsshell die Konfiguration eines Objekts in ein anderes Objekt kopieren können.
Anhand der Beispiele in diesem Thema wird die Verwendung von Vorlagen beim Erstellen eines neuen Postfachs mithilfe der Cmdlets New-Mailbox und Set-Mailbox erläutert. Vorlagen können mit vielen Cmdlets verwendet werden. Die besonderen Anforderungen für die einzelnen Cmdlets können zwar voneinander abweichen, dennoch werden Vorlagen für alle Cmdlets auf die gleiche Weise verwendet.
Warum sind Vorlagen hilfreich?
In Microsoft Exchange Server 2007 können Sie mithilfe der Exchange-Verwaltungsshell Objekte wie Postfächer, Sendeconnectors und Richtlinien für E-Mail-Adresslisten verwalten. Diese Objekte können zahlreiche Eigenschaften aufweisen, die konfiguriert werden können. Eigenschaften, die von einem Administrator konfiguriert werden können, sind Eigenschaften, mit denen z. B. Folgendes festgelegt werden kann: ein bedingtes benutzerdefiniertes Attribut für eine E-Mailadresslistenrichtlinie, ob eine Remotedomäne das automatische Antworten auf das Internet zulässt und ob das DNS-Routing für einen Sendeconnector aktiviert ist.
Wenn Sie neue Objekte erstellen möchten, die auf der Konfiguration eines vorhandenen Objekts basieren, können Sie Vorlagen verwenden. Wenn Sie ein neues Objekt mithilfe einer Vorlage erstellen, kann die Exchange-Verwaltungsshell die Eigenschaften, die erforderlich sind, und die Eigenschaften, die eindeutig sein müssen, nicht klonen. Daher müssen Sie die diese Eigenschaften angeben, wenn das neue Objekt erstellt ist.
Im Folgenden wird dargestellt, wie Sie mithilfe einer Vorlage Zeit sparen können, wenn Sie 100 Postfächer mit der folgenden angepassten Konfiguration erstellen möchten:
| Eigenschaft | Angepasster Wert |
|---|---|
RetainDeletedItemsFor |
|
ProhibitSendQuota |
|
ProhibitSendReceiveQuota |
|
IssueWarningQuota |
|
UseDatabaseQuotaDefaults |
|
UseDatabaseRetentionDefaults |
|
Die Eigenschaften in dieser Tabelle sind Beispiele für die Eigenschaften, die Sie mithilfe der Exchange-Verwaltungsshell für Postfächer festlegen können. Wenn Sie ein neues Postfach mithilfe des Cmdlets New-Mailbox erstellen, können diese Eigenschaften nicht konfiguriert werden. Zum Konfigurieren der Eigenschaften müssen Sie das Cmdlet Set-Mailbox verwenden. Ohne Vorlagen müssen Sie jedes neue Postfach einzeln erstellen und dann die zugehörigen Eigenschaften konfigurieren. Unter Verwendung von Vorlagen können Sie ein Postfach erstellen und die zugehörigen Eigenschaften mithilfe des Cmdlets Set-Mailbox konfigurieren. Dann können Sie das erste Postfach als Vorlage verwenden und die verbleibenden Postfächer mithilfe dieser Vorlage erstellen.
Hinweis
Sie können auch mithilfe von Pipelining das neue Postfachobjekt von dem Cmdlet New-Mailbox an das Cmdlet Set-Mailbox übergeben. Mithilfe des Cmdlets Set-Mailbox können Sie die Eigenschaften des neuen Postfachs festlegen. Der Vorteil der Verwendung von Vorlagen besteht darin, dass Sie ein vorhandenes Objekt verwenden können, das genau so konfiguriert ist, wie die neuen Objekte konfiguriert sein sollen. Indem Sie ein vorhandenes Objekt verwenden, stellen Sie sicher, dass objektübergreifend eine konsistente Konfiguration aufrechterhalten wird.
Weitere Informationen zum Pipelining finden Sie unter Pipelining.
Wie werden Vorlagen von der Exchange-Verwaltungsshell implementiert?
Die Exchange-Verwaltungsshell ermöglicht Ihnen die Verwendung von Vorlagen durch Unterstützung des Parameters TemplateInstance für viele Cmdlets, die die Verben New, Add und Enable aufweisen. Der Parameter TemplateInstance akzeptiert ein Objekt, das den gleichen Typ wie das Objekt aufweist, das Sie erstellen möchten. Wenn Sie z. B. ein neues Postfach mithilfe des Cmdlets New-Mailbox erstellen möchten, müssen Sie ein Postfachobjekt auf den Parameter TemplateInstance anwenden. Weitere Informationen zu Cmdlets finden Sie unter Informationen zu Cmdlets. Weitere Informationen zu Objekten finden Sie unter Strukturierte Daten.
Hinweis
Möglicherweise möchten Sie Empfänger, z. B. Postfächer oder E-Mail-aktivierte Benutzer, erstellen, die als Vorlagen fungieren sollen. Informationen zum Sichern dieser speziellen Empfängervorlagen finden Sie unter Sichern von Empfängervorlagen.
Beim Ausführen eine Cmdlets mit dem Parameter TemplateInstance kombiniert das Cmdlet die Konfiguration, die von dem im Parameter TemplateInstance angegebenen Objekt abgerufen wird, mit den Werten, die Sie in den erforderlichen Parametern des Cmdlets angegeben haben. Das neue Objekt wird mit der kombinierten Konfiguration erstellt. Die Werte für einen erforderlichen Parameter können nicht mithilfe des Parameters TemplateInstance konfiguriert werden.
Hinweis
Wenn Sie beim Ausführen eines Cmdlets einen Parameter und seinen Wert angeben, überschreibt der mit diesem Parameter angegebene Wert den Wert, der für das Vorlagenobjekt konfiguriert ist.
Sie müssen zuerst das Objekt erstellen und dann die zugehörigen Eigenschaften konfigurieren, wenn Sie ein Objekt als Vorlage verwenden möchten. Wenn Sie das Objekt konfiguriert haben, können Sie unter Verwendung des zuvor konfigurierten Objekts als Vorlage weitere Objekte erstellen. Wenn Sie z. B. ein neues Postfach mit der Konfiguration erstellen möchten, die in der Tabelle im vorherigen Abschnitt aufgeführt wird, müssen Sie zuerst das Postfach mit dem Cmdlet New-Mailbox erstellen und dann die Eigenschaften des Postfachobjekts mithilfe des Cmdlets Set-Mailbox konfigurieren, wie im folgenden Beispiel veranschaulicht:
$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
Weitere Informationen zum Verwalten von Postfächern finden Sie unter Verwalten von Benutzerpostfächern.
Nachdem Sie ein Postfachobjekt erstellt und konfiguriert haben, das als Vorlage verwendet werden soll, können Sie weitere Postfachobjekte mit der gleichen Konfiguration erstellen. Zu diesem Zweck müssen Sie zuerst das als Vorlage zu verwendende Postfachobjekt einer Variablen zuordnen, wie im folgenden Beispiel veranschaulicht:
$Template = Get-Mailbox "Kim Akers"
Es ist dabei unerheblich, wie der Variablenname lautet. Weitere Informationen zu Variablen finden Sie unter Benutzerdefinierte Variablen.
Wenn Sie das als Vorlage zu verwendende Postfachobjekt ausgewählt haben, können Sie unter Verwendung dieser Vorlage ein neues Postfach erstellen, wie im folgenden Beispiel veranschaulicht:
$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
New-Mailbox -Name "David Simpson" -Database "Mailbox Database" -UserPrincipalName david@contoso.com -Password $Password -TemplateInstance $Template
Wenn Sie das neue Postfach erstellt haben, können Sie mithilfe des folgenden Befehls die Eigenschaften des auf Grundlage der Vorlage erstellten Postfachobjekts anzeigen, um zu überprüfen, ob sie korrekt festgelegt wurden:
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
Weitere Informationen zum Cmdlet Format-List finden Sie unter Arbeiten mit Ausgaben von Befehlen.
Erstellen mehrerer Objekte mithilfe von Vorlagen
Vorlagen sind äußerst hilfreich, wenn Sie viele Objekte gleichzeitig erstellen möchten. Beispielsweise kann es vorkommen, dass Sie Postfächer für alle Benutzer in einer CSV-Datei (Comma-Separated Value, durch Kommas getrennte Werte) erstellen und die gleiche Konfiguration für alle neuen Postfächer anwenden möchten. Wenn Sie das Cmdlet Import-CSV und das Cmdlet ForEach verwenden, können Sie die Daten aus der CSV-Datei einlesen und dann für jeden in der Liste aufgeführten Benutzer ein Postfach erstellen. Angenommen, Sie möchten neue Postfächer für die Benutzer in der folgenden CSV-Datei erstellen und die für das Postfachobjekt für Kim Akers konfigurierten Eigenschaften anwenden. Die CSV-Datei Users.csv enthält die folgenden Informationen:
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
Weisen Sie zuerst das Postfachobjekt zu, das die mit der Vorlage zu verwendende Konfiguration enthält, wie im folgenden Beispiel veranschaulicht:
$Template = Get-Mailbox "Kim Akers"
Danach können Sie die Postfächer mithilfe des Cmdlets Import-CSV und des Cmdlets ForEach erstellen:
$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 }
Weitere Informationen zum Cmdlet ForEach und zum Hinzufügen mehrerer Empfänger finden Sie unter den folgenden Themen: