New-ManagedContentSettings

Artikel
09/29/2014

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

Letztes Änderungsdatum des Themas: 2009-09-16

Verwenden Sie das Cmdlet New-ManagedContentSettings, um neue Einstellungen für verwaltete Inhalte von verwalteten Ordnern zu erstellen.

Syntax

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Bei den Einstellungen für verwalteten Inhalte handelt es sich um Einstellungen für verwaltete Ordner, die zum Steuern der Lebensdauer der in den Benutzerpostfächern enthaltenen Elemente verwendet werden. Die Lebensdauer wird durch zwei Verfahren gesteuert:

Durch Steuern der Inhaltsaufbewahrung und durch Entfernen von Inhalten, die nicht mehr benötigt werden.
Durch automatisches Verwenden der Journalfunktion, um wichtige Inhalte an einem separaten Speicherort außerhalb des Postfachs zu speichern.

Weitere Informationen zu Einstellungen für verwaltete Inhalte finden Sie unter Verwalten der Nachrichtendatensatzverwaltung.

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

Exchange-Organisationsadministrator (Rolle)

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

Parameter

Parameter	Erforderlich	Typ	Beschreibung
FolderName	Erforderlich	Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter	Der Parameter FolderName gibt den Namen oder die GUID des verwalteten Ordners an, für den die Einstellungen für verwaltete Inhalte gelten.
MessageClass	Erforderlich	System.String	Der Parameter MessageClass gibt den Nachrichtentyp an, auf den sämtliche Konfigurationseinstellungen für Ablauf- und Journalfunktion in diesen Inhaltseinstellungen angewendet werden. Der Parameterwert muss eine bestimmte Nachrichtenklasse sein, z. B. IPM.NOTE.SMIME, oder eine benutzerdefinierte Nachrichtenklasse. Die folgenden Parameter sind z. B. für benutzerdefinierte Nachrichtenklassen gültig: Eine bestimmte Nachrichtenklasse (z. B. IPM.NOTE) Das Platzhalterzeichen Sternchen (), das angibt, dass die Inhaltseinstellungen für alle Nachrichtenklassen gelten. Eine bestimmte Nachrichtenklasse, die das Platzhalterzeichen Sternchen enthält. Das Platzhalterzeichen Sternchen muss als letztes Zeichen in der Nachrichtenklasse auftreten. Beispiele: IPM.NOTE (Diese Angabe umfasst IPM.NOTE und alle Unterklassen.) IPM.NOTE.* (Diese Angabe umfasst die Unterklassen für IPM.NOTE, nicht jedoch IPM.NOTE selbst) .NOTE und IPM..NOTE sind nicht zulässig. Hinweis Wenn Platzhalterzeichen verwendet werden, gelten diese Richtlinien nur für Nachrichtenklassen, die keine bestimmte Inhaltseinstellung aufweisen. Daher besitzt IPM.NOTE.SMIME** Vorrang vor IPM.NOTE.* Hinweis Bestimmte Einstellungen werden durch allgemeine Einstellungen außer Kraft gesetzt. Voicemail besitzt beispielsweise Vorrang vor Gesamter Postfachinhalt. Die folgende Liste beschreibt bekannte Nachrichtentypen und gibt die Werte an, die verwendet werden müssen: Verwenden Sie für den Nachrichtentyp Gesamter Postfachinhalt den Wert . Verwenden Sie für den Nachrichtentyp Kalenderelemente* den Wert IPM.Appointment. Verwenden Sie für den Nachrichtentyp Kontakte* den Wert IPM.Contact. Verwenden Sie für den Nachrichtentyp Dokumente* den Wert IPM.Document. Verwenden Sie für den Nachrichtentyp Faxe* den Wert IPM.Note.Microsoft.Fax. Verwenden Sie für den Nachrichtentyp Journal den Wert IPM.Activity. Verwenden Sie für den Nachrichtentyp Besprechungsanfragen, Antworten und Absagen den Wert IPM.Schedule. Verwenden Sie für den Nachrichtentyp Notizen* den Wert IPM.StickyNote. Verwenden Sie für den Nachrichtentyp Bereitstellungen den Wert IPM.Post. Verwenden Sie für den Nachrichtentyp RSS-Elemente den Wert IPM.Post.RSS. Verwenden Sie für den Nachrichtentyp Aufgaben den Wert IPM.Task. Verwenden Sie für den Nachrichtentyp Voicemail* den Wert IPM.Note.Microsoft.Voicemail*.
Name	Erforderlich	System.String	Der Parameter Name gibt einen eindeutigen Namen für die Einstellungen für verwaltete Inhalte an.
AddressForJournaling	Optional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter	Der Parameter AddressForJournaling gibt die Adresse des Repositorys an, das als Ziel der Journaloperation fungiert. Wird dieser Parameter nicht angegeben, und der Parameter JournalingEnabled ist auf `$true` festgelegt, wird ein Fehler zurückgegeben.
AgeLimitForRetention	Optional	System.Nullable	Der Parameter AgeLimitForRetention gibt das Alter an, ab dem für ein Element die Aufbewahrung erzwungen wird. Die Altersbegrenzung entspricht der Anzahl der Tage seit dem Zustellungsdatum des Elements oder seit dem Erstellungsdatum, falls das Element nicht zugestellt wurde. Wird dieser Parameter nicht angegeben, und der Parameter RetentionEnabled ist auf `$true` festgelegt, wird ein Fehler zurückgegeben.
Confirm	Optional	System.Management.Automation.SwitchParameter	Der Parameter Confirm 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.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsinformationen in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu.
JournalingEnabled	Optional	System.Boolean	Der Parameter JournalingEnabled gibt an, dass die Journalfunktion aktiviert ist, wenn er auf `$true` gesetzt ist.
LabelForJournaling	Optional	System.String	Der Parameter LabelForJournaling gibt eine Bezeichnung an, die dem Element zugeordnet wird. Diese Bezeichnung wird vom Zielinformationsspeicher verwendet, um den Inhalt des Elements zu ermitteln und die entsprechende Richtlinie zu erzwingen.
MessageFormatForJournaling	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat	Der Parameter MessageFormatForJournaling ermöglicht es dem Administrator festzulegen, dass die Journalfunktion auf ein Element im Microsoft Outlook-Format .msg oder im herkömmlichen Outlook-MAPI-Format angewendet wird.
MoveToDestinationFolder	Optional	Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter	Der Parameter MoveToDestinationFolder gibt den Zielordner für einen Verschiebevorgang an. Der Zielordner muss ein vorhandener, verwalteter, benutzerdefinierter Ordner sein. Ist dies nicht der Fall, wird ein Fehler zurückgegeben. Wird der Parameter MoveToDestinationFolder nicht angegeben und der Aufbewahrungsvorgang ist MoveToFolder, dann wird ein Fehler zurückgegeben.
RetentionAction	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType	Der Parameter RetentionAction gibt einen der folgenden Vorgänge an: Als nach dem Aufbewahrungslimit liegend markieren In einen verwalteten benutzerdefinierten Ordner verschieben In den Ordner Gelöschte Elemente verschieben Löschen und Wiederherstellung zulassen Permanent löschen Wird dieser Parameter nicht angegeben, und der Parameter RetentionEnabled ist auf `$true` festgelegt, wird ein Fehler zurückgegeben.
RetentionEnabled	Optional	System.Boolean	Der Parameter RetentionEnabled gibt an, dass die Aufbewahrung aktiviert ist, wenn er auf `$true` gesetzt ist.
TemplateInstance	Optional	System.Management.Automation.PSObject	Wenn ein vorhandenes Objekt an den Parameter TemplateInstance übergeben wird, verwendet der Befehl die Konfiguration dieses Objekts zum Erstellen eines exakten Duplikats des Objekts auf einem lokalen oder Zielserver.
TriggerForRetention	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType	Der Parameter TriggerForRetention gibt das Startdatum an, das als Startzeitpunkt für den Aufbewahrungszeitraum verwendet wird. Ein Element kann sein Aufbewahrungslimit nach einer bestimmten Anzahl von Tagen erreichen, nachdem das Element zugestellt wurde oder nachdem es in einen bestimmten Ordner verschoben wurde. Dieser Wert entspricht dem 0x4-Bit des Attributs msExchELCFlags in Active Directory. Das Kennzeichen erhält den Wert `$true`, wenn das Element auf Basis des Datums abläuft, an dem es verschoben wurde. Das Kennzeichen erhält den Wert `$false`, wenn das Element auf Basis des Zustelldatums abläuft. Wenn dieser Parameter nicht angegeben wurde und der Parameter RetentionEnabled den Wert `$true` besitzt, wird ein Fehler zurückgegeben.
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 Parameters WhatIf 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

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Im ersten Beispiel wird der Befehl New-ManagedContentSettings verwendet, um die Einstellungen für verwaltete Inhalte der Nachrichtenklasse Calendar zu erstellen, die mit MyManagedFolderMailboxPolicy bezeichnet wird. Die Einstellungen für verwaltete Inhalte gelten für den Standardordner Calendar. Die Aufbewahrung ist aktiviert und die Elemente werden nach 30 Tagen in den Ordner Gelöschte Elemente verschoben.

Im zweiten Beispiel werden Stubs (einer benutzerdefinierten Nachrichtenklasse namens IPM.Note.Archive.Shortcut) für archivierte Inhalte im Posteingang von Benutzern mit der verwalteten Inhaltseinstellung namens RemoveArchiveStubs gelöscht.

Weitere Informationen zu benutzerdefinierten Nachrichtenklassen finden Sie in der Beschreibung zum Parameter MessageClass in diesem Thema sowie im Abschnitt "Informationen zu Nachrichtenklassen" im Microsoft Knowledge Base-Artikel 241235, Globale Änderung der Standardformulare in Outlook mithilfe des Dienstprogramms 'Forms Administrator' (englischsprachig).

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"