New-ManagedFolder

Modul:

ExchangePowerShell

Gilt für::

Exchange Server 2010

Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.

für die Organisation konfiguriertCmdlet New-ManagedFolder, um ein verwaltetes Ordnerobjekt für die Messaging-Datensatzverwaltung (Messaging Records Management, MRM) zu erstellen.

Dieser Befehl akzeptiert keine Eingaben mittels Pipeline.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

New-ManagedFolder
   [-Name] <String>
   -DefaultFolderType <DefaultManagedFolderType>
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

New-ManagedFolder
   [-Name] <String>
   -FolderName <String>
   [-LocalizedFolderName <MultiValuedProperty>]
   [-StorageQuota <Unlimited>]
   [-BaseFolderOnly <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalizedComment <MultiValuedProperty>]
   [-MustDisplayCommentEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-ManagedFolder erstellt einen neuen verwalteten Ordner in Active Directory. Nachdem ein neues verwaltetes Ordnerobjekt erstellt wurde, müssen folgende Schritte ausgeführt werden, damit es für die Messaging-Datensatzverwaltung verwendet werden kann:

• Erstellen Sie Einstellungen für verwaltete Inhalte für den Ordner. Informationen finden Sie unter Create Managed Content Settings.
• Verknüpfen Sie den verwalteten Ordner mit einer vorhandenen Postfachrichtlinie für verwalteten Ordner, oder erstellen Sie eine Postfachrichtlinie für verwalteten Ordner, und verknüpfen Sie den verwalteten Ordner mit dieser Richtlinie.
• Wenden Sie die Postfachrichtlinie für verwalteten Ordner auf das Postfach des Benutzers an. Weitere Informationen finden Sie unter Anwenden einer Postfachrichtlinie für verwaltete Ordner auf Benutzer.
• Stellen Sie sicher, dass der Zeitplan für den Assistenten für verwaltete Ordner festgelegt ist, oder führen Sie den Assistenten manuell aus. Informationen zum Planen des Assistenten für verwaltete Ordner finden Sie unter Konfigurieren des Assistenten für verwaltete Ordner. Bei der Ausführung des Assistenten für verwaltete Ordner werden Standardordner als verwaltete Ordner konfiguriert und alle verwalteten benutzerdefinierten Ordner im Postfach des Benutzers mit den angegebenen Einstellungen erstellt.
• Weitere Informationen zu den Schritten zum Implementieren von MRM in Microsoft Exchange Server 2010 finden Sie unter Bereitstellen der Verwaltung von Nachrichtendatensätzen.

Standardmäßig werden verwaltete benutzerdefinierte Ordner mit diesem Cmdlet erstellt. Sie können jedoch auch zusätzliche Kopien von verwalteten Standardordnern erstellen, indem Sie den DefaultFolderType-Parameter verwenden, um anzugeben, welcher Standardordnertyp erstellt werden soll (z. B. einen zusätzlichen Posteingangsordner). Wenn Sie mehrere Kopien eines verwalteten Standardordners erstellen, können Sie jedem ordner unterschiedliche Inhaltseinstellungen zuweisen. Beispielsweise könnten Sie über zwei Posteingangsordner verfügen, einen mit dem Namen InboxSixMonths und einen mit dem Namen InboxOneYear. Anschließend können Sie dem ersten Ordner mit dem Cmdlet New-ManagedContentSettings eine Aufbewahrungsdauer von sechs Monaten und dem zweiten Ordner ein Jahr zuweisen (oder den Assistenten Für neue Einstellungen für verwaltete Inhalte in der Exchange-Verwaltungskonsole verwenden). Sie müssen jedem der verwalteten Standardordner, die Sie erstellen, einen eindeutigen Namen (mithilfe des Parameters Name) zuweisen. Benutzern wird jedoch immer der unveränderte Standardordnername angezeigt. Im Beispiel wird unabhängig davon, ob Benutzern ein Ordner "InboxSixMonths" oder "InboxOneYear" zugewiesen ist, der Posteingang, der in ihrem Postfach angezeigt wird, als Posteingang bezeichnet. Obwohl die Ordnernamen, die Benutzern in ihren Postfächern angezeigt werden, für verwaltete benutzerdefinierte Ordner neu zugewiesen werden können (mithilfe des Set-ManagedFolder Befehls FolderName-Parameter), können die Ordnernamen, die von Benutzern für verwaltete Standardordner angezeigt werden, nicht geändert werden.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"

In diesem Beispiel wird ein verwalteter Ordner mit einer Höchstkapazität von 1 MB erstellt.

Beispiel 2

New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"

In diesem Beispiel wird einen verwalteter Ordner mit einem Standardordnernamen und Kommentar in Englisch, einem lokalisierten Ordnernamen in Spanisch und Französisch und einem lokalisierten Kommentar in Spanisch und Französisch erstellt.

Beispiel 3

New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox

In diesem Beispiel wird eine Instanz des Standardordners "Inbox" erstellt.

Parameter

-BaseFolderOnly

Der Parameter BaseFolderOnly gibt an, ob die Einstellungen für verwaltete Inhalte nur auf den verwalteten Ordner oder auf den Ordner und alle zugehörigen Unterordner angewendet werden sollen.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Comment

Der Parameter Comment gibt den Standardadministratorkommentar an, der mit dem Ordner in Microsoft Office Outlook 2007 und Microsoft Office Outlook Web App angezeigt werden soll. Der Kommentar kann bis zu 255 Zeichen einschließlich Leerzeichen umfassen.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

• Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
• Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DefaultFolderType

Der Parameter DefaultFolderType gibt an, welcher Typ von Standardordner erstellt werden soll (z. B. "Inbox" oder "Gelöschte Elemente").

Für eine Postfachrichtlinie für verwalteten Ordner ist nur ein verwalteter Ordner eines bestimmten Standardordnertyps zulässig. Zusätzliche Standardordner eines bestimmten Typs, z. B. "Posteingang", können erstellt und anderen Postfachrichtlinien hinzugefügt werden. Auf diese Weise können Sie einem bestimmten Standardordnertyp für unterschiedliche Gruppen von Benutzern verschiedene Einstellungen für verwaltete Inhalte zuweisen.

Sie können beispielsweise zwei Standardordner vom Typ "Posteingang" einrichten, wobei mithilfe der Einstellungen für verwaltete Inhalte für den einen Ordner festgelegt ist, dass Nachrichten für einen Monat aufbewahrt werden, und für den anderen Ordner, dass Nachrichten für ein Jahr aufbewahrt werden. Jeder verwaltete Standardordner sollte einen eindeutigen Namen aufweisen (der mithilfe des Parameters Name zugewiesen wird).

Wenn für den Parameter DefaultFolderType kein Wert angegeben wird, wird der Ordner als verwalteter benutzerdefinierter Ordner behandelt.

Folgende Standardordnertypen können angegeben werden:

• Kalender
• Kontakte
• DeletedItems
• Entwürfe
• Posteingang
• JunkEmail
• Journal
• Notizen
• Postausgang
• SentItems
• Aufgaben
• Alle
• ManagedCustomFolder
• RssSubscriptions
• SyncIssues
• ConversationHistory

Type:	DefaultManagedFolderType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-FolderName

Der Parameter FolderName gibt den Namen des Ordners an, wie er in Postfächern von Benutzern angezeigt wird. Der Ordnername kann bis zu 255 Zeichen lang sein. Der Parameter FolderName kann für verwaltete Standardordner, z. B. "Inbox", nicht festgelegt werden.

Der Parameter FolderName darf nicht mit dem Parameter Name verwechselt werden.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedComment

Der Parameter LocalizedComment gibt lokalisierte Administratorkommentare mit den dazugehörigen Sprachen an. Wenn die Spracheinstellung von Outlook 2007 mit einem der in diesem Parameter angegebenen Gebietsschemas übereinstimmt, wird der entsprechende lokalisierte Kommentar angezeigt. Kommentare müssen das Format ISO-Sprachcode:Kommentar aufweisen (z. B. -LocalizedComment DE-DE:"Dies ist ein lokalisierter Kommentar in Deutsch.").

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LocalizedFolderName

Der Parameter LocalizedFolderName gibt die lokalisierten Ordnernamen mit den dazugehörigen Sprachen an. Wenn die Spracheinstellung von Outlook 2007 mit einem der in diesem Parameter angegebenen Gebietsschemas übereinstimmt, wird der entsprechende lokalisierte Ordnername angezeigt. Ordnernamen müssen das Format ISOLanguageCode:FolderName haben (z. B. -LocalizedFolderName DE-DE:"Geschäftskritisch").

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MustDisplayCommentEnabled

Der Parameter MustDisplayCommentEnabled gibt an, ob ein von Outlook 2007 verwendetes Flag festgelegt werden soll, um zu verhindern, dass Benutzer einen Ordnerkommentar (der in Outlook 2007 und Outlook Web App sichtbar ist) minimieren. Wenn der MustDisplayCommentEnabled-Parameter vorhanden und auf $true festgelegt ist, legt der Parameter ein Flag fest, das von Outlook 2007 verwendet wird, um zu verhindern, dass Benutzer einen Ordnerkommentar minimieren. Wenn dieser Parameter nicht angegeben oder auf $false gesetzt ist, können Benutzer den Kommentar minimieren.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

Der Parameter Name gibt einen eindeutigen Namen für das Objekt des verwalteten Ordners in Active Directory an. Der Name kann bis zu 65 Zeichen umfassen. Während der Parameter FolderName den Ordnernamen angibt, wie er Benutzern in Clients angezeigt wird, wird der Parameter Name von Exchange-Verwaltungstools verwendet, um das verwaltete Ordnerobjekt darzustellen.

Der Parameter Name darf nicht mit dem Parameter FolderName verwechselt werden.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-StorageQuota

Der Parameter StorageQuota gibt den Grenzwert für die Speichergröße des Postfachordners an. Wenn die Größe des Ordners diesen Grenzwert überschreitet, dürfen keine zusätzlichen Elemente mehr hinzugefügt werden. Speichergrößenbeschränkungen können in Kilobytes (KB) oder Megabytes (MB) angegeben werden, beispielsweise 100 KB oder 5 MB.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.