Import-Mailbox

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2011-06-21

Verwenden Sie das Cmdlet Import-Mailbox zum Importieren von Postfachdaten aus einer PST-Datei in ein Postfach.

Syntax

import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Damit Sie das Cmdlet Import-Mailbox ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

  • Vollständiger Zugriff auf das Zielpostfach

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Um Vollzugriff auf ein Postfach zu gewähren, verwenden Sie das Cmdlet Add-MailboxPermission und geben als Wert für den Parameter AccessRights "FullAccess" an.

Damit Daten aus einer PST-Datei importiert werden können, müssen Sie das Cmdlet Import-Mailbox auf einem 32-Bit-Computer ausführen, auf dem folgende Komponenten installiert sind:

  • Die 32-Bit-Version der Exchange-Verwaltungstools

  • Microsoft Office Outlook 2003 Service Pack 2 (SP2) oder höher

Weitere Downloadinformationen zu den Exchange 2007-Verwaltungstools (32-Bit) finden Sie unter Microsoft Exchange Server 2007-Verwaltungstools (32-Bit).

Sie können das Cmdlet Import-Mailbox verwenden, um Daten in einen Ordner oder eine PST-Datei zu importieren. Die Quell- und Zielpostfächer müssen sich auf einem Computer befinden, auf dem eine der folgenden Microsoft Exchange-Versionen ausgeführt wird:

  • Exchange Server 2007

  • Exchange Server 2003 Service Pack 2 (SP2) oder höher

  • Exchange 2000 Server Service Pack 3 (SP3) oder höher

Um Daten aus einer PST-Datei in ein Postfach auf einem Server zu importieren, auf dem eine andere Version von Exchange ausgeführt wird, verwenden Sie den Microsoft Exchange Server Mailbox Merge Wizard (ExMerge.exe) (englischsprachig).

Mit dem Cmdlet Import-Mailbox können Sie keine Daten aus einer PST-Datei in ein Postfach importieren, das sich in einer Wiederherstellungsspeichergruppe (Recovery Storage Group, RSG) befindet.

Mit dem Cmdlet Import-Mailbox können Sie keine Daten in eine Öffentliche Ordner-Datenbank importieren.

Hinweis

Sie müssen kein MAPI-Profil konfigurieren, wenn Sie das Cmdlet Import-Mailbox verwenden.

Parameter

Parameter Erforderlich Typ Beschreibung

PSTFolderPath

Erforderlich

Microsoft.Exchange.Data.LongPath

Der Parameter PSTFolderPath gibt den Pfad der PST-Datei an, aus der die Daten importiert werden sollen.

AllContentKeywords

Optional

System.String[]

Der Parameter AllContentKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Findet der Befehl ein im Nachrichtentext, Anlageninhalt oder Betreff angegebenes Schlüsselwort, so werden die entsprechenden Nachrichten importiert.

Hinweis

Dies unterscheidet sich von der Verwendung der Parameter ContentKeywords und SubjectKeywords. Bei Verwendung der Parameter ContentKeywords und SubjectKeywords importiert der Befehl nur Nachrichten, die sowohl das für den Parameter ContentKeywords angegebene Schlüsselwort im Nachrichtentext oder Anlageninhalt als auch das für den Parameter SubjectKeywords angegebene Schlüsselwort im Betreff aufweisen.

AllowDuplicates

Optional

System.Management.Automation.SwitchParameter

Der Parameter AllowDuplicates wird zum Kopieren von Nachrichtenelementen verwendet. Dabei erfolgt keine Überprüfung, ob es sich um Duplikate vorhandener Elemente handelt, und Duplikatelemente werden auch nicht entfernt. Es wird empfohlen, den Parameter AllowDuplicates zusammen mit dem Parameter IncludeFolders zu verwenden.

AttachmentFilenames

Optional

System.String[]

Der Parameter AttachmentFilenames gibt den Filter für Anlagen an. Sie können Platzhalterzeichen in der Zeichenfolge verwenden. Zum Importieren von Elementen mit der Erweiterung TXT können Sie beispielsweise "*.txt" verwenden.

BadItemLimit

Optional

System.Int32

Der Parameter BadItemLimit gibt an, wie viele beschädigte Elemente in einer PST-Datei ausgelassen werden können, bevor der Importvorgang fehlschlägt.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden.

ContentKeywords

Optional

System.String[]

Der Parameter ContentKeywords gibt die Schlüsselwörter für den in den Import einzuschließenden Inhalt an. Findet der Befehl ein im Nachrichtentext oder Anlageninhalt angegebenes Schlüsselwort, so werden die entsprechenden Nachrichten importiert.

EndDate

Optional

System.DateTime

Der Parameter EndDate legt das Enddatum zum Filtern des Inhalts fest, der in das Zielpostfach importiert wird. Es werden nur die Elemente in der PST-Datei importiert, deren Datum entweder vor dem Enddatum liegt oder diesem entspricht. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.JJJJ konfiguriert ist, geben Sie für den 1. März 2006 Folgendes ein: 01.03.2006.

ExcludeFolders

Optional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Der Parameter ExcludeFolders gibt die Liste der vom Import auszuschließenden Ordner an.

GlobalCatalog

Optional

Microsoft.Exchange.Data.Fqdn

Der Parameter GlobalCatalog gibt den globalen Katalog an, der für die Suche nach dem Zielpostfach verwendet wird.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Identity gibt das Zielpostfachobjekt an, in das die Daten importiert werden sollen. Einer der folgenden Werte kann verwendet werden:

  • ADObjectID

  • Distinguished Name (DN)

  • Legacy-Exchange-DN

  • GUID

  • Domäne\Kontoname

  • Benutzerprinzipalname (User Principal Name, UPN)

  • E-Mail-Adresse

  • Alias

Wird das Get-Mailbox-Befehlsobjekt mithilfe einer Pipeline übergeben, muss dieser Parameter nicht angegeben werden.

IncludeFolders

Optional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Der Parameter IncludeFolders gibt die Liste der zu importierenden Ordner an.

Locale

Optional

System.Globalization.CultureInfo

Der Parameter Locale gibt das Gebietsschema der zu importierenden Nachrichten an. Mit dem Befehl werden nur Nachrichten mit dem angegebenen Gebietsschema importiert.

MaxThreads

Optional

System.Int32

Der Parameter MaxThreads gibt die maximale Anzahl der Threads an, die verwendet werden. Der Standardwert ist 4.

RecipientKeywords

Optional

System.String[]

Der Parameter RecipientKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Wenn der Befehl ein Schlüsselwort findet, das Sie in der Empfängerliste angegeben haben, werden diese Nachrichten importiert.

ReportFile

Optional

Microsoft.Exchange.Data.LocalLongFullPath

Der Parameter ReportFile gibt den Pfad und den Dateinamen für das XML-Berichtsprotokoll an.

SenderKeywords

Optional

System.String[]

Der Parameter SenderKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Wenn der Befehl ein Schlüsselwort findet, das Sie in der Senderliste angegeben haben, werden diese Nachrichten importiert.

StartDate

Optional

System.DateTime

Der Parameter StartDate legt das Startdatum zum Filtern des Inhalts fest, der in das Zielpostfach importiert wird. Es werden nur die Elemente in der PST-Datei importiert, deren Datum nach dem angegebenen Startdatum liegt. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.JJJJ konfiguriert ist, geben Sie für den 1. März 2006 Folgendes ein: 01.03.2006.

SubjectKeywords

Optional

System.String[]

Der Parameter SubjectKeywords legt die Schlüsselwortfilter für den Betreff der Elemente in der PST-Datei fest.

ValidateOnly

Optional

System.Management.Automation.SwitchParameter

Mit dem Parameter ValidateOnly kann der Importvorgang überprüft werden, ohne die Daten zu importieren. Durch den Parameter ValidateOnly werden alle Voraussetzungen für den Befehl überprüft.

Hinweis

Wenn Sie den Befehl Import-Mailbox mit diesem Parameter ausführen, werden keine Filter auf die Nachrichten angewendet. Es wird nur überprüft, ob die Quell- und Zielpostfächer vorhanden sind.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Beispiel

Im ersten Beispiel wird gezeigt, wie Daten aus der Datei C:\PSTFiles\john.pst in ein vorhandenes, verbundenes Postfach mit Namen john@contoso.com importiert werden.

Im zweiten Beispiel wird gezeigt, wie Daten aus allen PST-Dateien im Pfad C:\PSTFiles in vorhandene Postfächer importiert werden. Die PST-Dateien müssen den Namen <Alias>.pst tragen, wobei Alias der Alias des Postfachs ist, in das die Daten importiert werden sollen. Aus jeder PST-Datei werden nur Nachrichten in das Postfach importiert, die nach dem 01.01.2007 empfangen wurden.

Im dritten Beispiel wird gezeigt, wie Daten aus einer PST-Datei in Postfächer importiert werden, deren Benutzer sich in der Organisationseinheit Marketing befinden. Die PST-Dateien müssen den Namen <Alias>.pst tragen, wobei Alias der Alias des Postfachs ist, in das die Daten importiert werden sollen. Es werden nur PST-Dateien importiert, deren Alias dem eines Benutzers in der Organisationseinheit Marketing entspricht. Befindet sich im Pfad C:\PSTFiles keine PST-Datei für einen Benutzer in der Organisationseinheit Marketing, wird eine Fehlermeldung ausgegeben.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles