Import-Mailbox

Artikel
05/20/2011

Gilt für: Exchange Server 2010

Letztes Änderungsdatum des Themas: 2009-07-12

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>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Parameter

Parameter	Erforderlich	Typ	Beschreibung
PSTFolderPath	Erforderlich	Microsoft.Exchange.Data.LongPath	Der Parameter PSTFolderPath gibt den Pfad der PST-Datei an, aus der Daten importiert werden sollen.
AllContentKeywords	Optional	System.String[]	Der Parameter AllContentKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Wird vom Befehl ein von Ihnen angegebenes Schlüsselwort im Nachrichtentext, Anlageninhalt oder Betreff gefunden, werden die entsprechenden Nachrichten importiert. Hinweis: Dies unterscheidet sich von der Verwendung der Parameter ContentKeywords und SubjectKeywords. Wenn Sie sowohl den Parameter ContentKeywords als auch den Parameter SubjectKeywords verwenden, werden von dem Befehl nur Nachrichten importiert, die sowohl das für den Parameter ContentKeywords angegebene Schlüsselwort im Nachrichtentext oder Anlageninhalt enthalten als auch das für den Parameter SubjectKeywords angegebene Schlüsselwort im Betreff aufweisen.
AllowDuplicates	Optional	System.Management.Automation.SwitchParameter	Die Option AllowDuplicates gibt an, ob E-Mail-Elemente kopiert werden sollen, ohne zu prüfen, ob es sich um Duplikate bereits vorhandener Elemente handelt. Es wird empfohlen, den Parameter AllowDuplicates mit dem Parameter IncludeFolders zu verwenden.
AttachmentFilenames	Optional	System.String[]	Der Parameter AttachmentFilenames gibt den Filter für Anlagen an. In dieser Zeichenfolge können Platzhalterzeichen verwendet werden. 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	Die Option Confirm kann zum Unterdrücken der Bestätigungsaufforderung verwendet werden, die standardmäßig angezeigt wird, wenn dieses Cmdlet ausgeführt wird. Verwenden Sie zum Unterdrücken dieser Bestätigungsaufforderung die Syntax `-Confirm:$False`. Sie müssen einen Doppelpunkt (`:`) in der Syntax einfügen.
ContentKeywords	Optional	System.String[]	Der Parameter ContentKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Wird von dem Befehl ein von Ihnen angegebenes Schlüsselwort im Nachrichtentext oder Anlageninhalt gefunden, werden die entsprechenden Nachrichten importiert.
EndDate	Optional	System.DateTime	Der Parameter EndDate gibt das Enddatum zum Filtern des Inhalts an, der in das Zielpostfach importiert wird. Es werden nur diejenigen Elemente in der PST-Datei importiert, deren Datum 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 Einstellungen. Falls der Computer so konfiguriert ist, dass das kurze Datumsformat TT.MM.JJJJ verwendet wird, geben Sie für den 1. März 2010 Folgendes ein: 01.03.2010.
ExcludeFolders	Optional	Microsoft.Exchange.Data.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 werden soll.
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.
IncludeAssociatedMessages	Optional	System.Management.Automation.SwitchParameter	Der Parameter IncludeAssociatedMessages gibt an, dass zugeordnete Nachrichten in den Import eingeschlossen werden. Zugeordnete Nachrichten enthalten ausgeblendete Daten mit Informationen zu Regeln, Ansichten und Formularen. Standardmäßig werden zugeordnete Nachrichten nicht in den Import eingeschlossen.
IncludeFolders	Optional	Microsoft.Exchange.Data.MapiFolderPath[]	Der Parameter IncludeFolders gibt die Liste der zu importierenden Ordner an. Wenn Sie diesen Parameter verwenden, werden nur Ordner in der Parameterliste in den Import eingeschlossen.
Locale	Optional	System.Globalization.CultureInfo	Der Parameter Locale gibt das Gebietsschema der zu importierenden Nachrichten an. Durch den 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. Wird von dem Befehl ein von Ihnen angegebenes Schlüsselwort in der Empfängerliste gefunden, werden die entsprechenden Nachrichten importiert.
SenderKeywords	Optional	System.String[]	Der Parameter SenderKeywords gibt die Schlüsselwörter für den zu importierenden Inhalt an. Wird von dem Befehl ein von Ihnen angegebenes Schlüsselwort in der Absenderliste gefunden, werden die entsprechenden Nachrichten importiert.
StartDate	Optional	System.DateTime	Der Parameter StartDate gibt das Startdatum zum Filtern des Inhalts an, der in das Zielpostfach importiert wird. Es werden nur diejenigen Elemente in der PST-Datei importiert, deren Datum hinter dem angegebenen Startdatum liegt. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Einstellungen. Falls der Computer so konfiguriert ist, dass das kurze Datumsformat TT.MM.JJJJ verwendet wird, geben Sie für den 1. März 2010 Folgendes ein: 01.03.2010.
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	Die Option ValidateOnly weist das Cmdlet an, die zur Durchführung des Vorgangs erforderlichen Bedingungen und Anforderungen auszuwerten, und berichtet dann, ob der Vorgang erfolgreich sein oder fehlschlagen wird. Es werden keine Änderungen vorgenommen, wenn die Option ValidateOnly verwendet wird. Hinweis: Wenn Sie den Befehl Import-Mailbox mit dieser Option 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	Die Option WhatIf weist den Befehl an, die für das Objekt auszuführenden Aktionen zu simulieren. Durch Verwendung der Option WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für die Option WhatIf muss kein Wert angegeben werden.

Detaillierte Beschreibung

Damit Daten aus einer PST-Datei importiert werden können, müssen Sie das Cmdlet Import-Mailbox auf einem Computer mit Microsoft Exchange Server 2010 ausführen, auf dem die 64-Bit-Version von Microsoft Outlook 2010 installiert ist. Es wird empfohlen, den Befehl auf einem dedizierten Exchange-Server auszuführen, auf dem sich keine Postfächer befinden.

Mit dem Cmdlet Import-Mailbox können Sie Daten aus einer PST-Datei nur in ein Postfach importieren, das sich auf einem Server mit Exchange 2010 mit installierter Postfachserverrolle befindet. Zum Importieren von Daten aus einer PST-Datei in ein Postfach auf einem Server mit Exchange Server 2007 müssen Sie die in Exchange 2007 verfügbare Version des Cmdlets Import-Mailbox verwenden. Zum Importieren von Daten aus einer PST-Datei in ein Postfach auf einem Server mit Exchange Server 2003 müssen Sie den Assistenten zum Zusammenführen von Postfächern (ExMerge.exe) von Microsoft Exchange verwenden.

Es ist nicht möglich, mit dem Cmdlet Import-Mailbox Daten aus einer PST-Datei in ein Postfach zu importieren, das sich in einer Wiederherstellungsdatenbank befindet.

Es ist nicht möglich, mit dem Cmdlet Import-Mailbox Daten in eine Öffentliche Ordner-Datenbank zu importieren.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie besitzen möglicherweise keinen Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter: "Importieren/Exportieren von Postfächern" - Eintrag im Thema Postfachberechtigungen.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Beispiele

BEISPIEL 1

In diesem Beispiel werden Daten aus der Datei "C:\PSTFiles\john.pst" in das vorhandene, verbundene Postfach "john@contoso.com" importiert.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst

BEISPIEL 2

In diesem Beispiel werden Daten aus allen PST-Dateien, die sich unter "C:\PSTFiles" befinden, in vorhandene Postfächer importiert. 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 die Nachrichten in das Postfach importiert, die nach dem 01.01.2010 empfangen wurden.

Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010

BEISPIEL 3

In diesem Beispiel werden Daten aus einer PST-Datei in Postfächer importiert, deren Benutzer zur Organisationseinheit "Marketing" gehören. 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 einem Benutzer in der Organisationseinheit "Marketing" entspricht. Befindet sich unter "C:\PSTFiles" keine PST-Datei für einen Benutzer in der Organisationseinheit "Marketing", wird eine Fehlermeldung ausgegeben.

Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles