New-ManagedContentSettings

Modul:

ExchangePowerShell

Gilt für::

Exchange Server 2010

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

Verwenden Sie das Cmdlet New-ManagedContentSettings, um Einstellungen für verwaltete Inhalte für verwaltete Ordner zu erstellen.

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

Syntax

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Bei den Einstellungen für verwaltete 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 den Einstellungen für verwaltete Inhalte finden Sie unter Messaging-Datensatzverwaltung.

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-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

In diesem Beispiel werden Einstellungen für verwaltete Inhalte für den verwalteten Standardordner "Exec-DeletedItems" erstellt. Wenn Elemente zu einer Postfachrichtlinie für verwalteten Ordner hinzugefügt und auf ein Postfach angewendet werden, werden Elemente im Ordner "Gelöschte Objekte" 30 Tage nach dem Zustelldatum endgültig gelöscht.

Beispiel 2

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180

In diesem Beispiel werden die Einstellungen für verwaltete Inhalte "CS-Exec-Calendar" für die Nachrichtenklasse Calendar erstellt. Die Einstellungen für verwaltete Inhalte gelten für den Standardordner Calendar. Die Aufbewahrung ist aktiviert und die Elemente werden nach 180 Tagen in den Ordner "Gelöschte Elemente" verschoben.

Parameter

-AddressForJournaling

Der Parameter AddressForJournaling gibt den Journalempfänger an, an den Journalnachrichten gesendet werden. Sie können jeden Wert verwenden, der den Empfänger eindeutig bestimmt. Beispiel:

• Name
• Alias
• Distinguished Name (DN)
• Distinguished Name (DN)
• Kanonischer DN
• GUID

Dieser Parameter ist erforderlich, wenn der Parameter JournalingEnabled auf $true festgelegt ist.

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

-AgeLimitForRetention

Der Parameter AgeLimitForRetention gibt das Alter an, ab dem für ein Element die Aufbewahrung erzwungen wird. Die Verfallszeit 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 auf $true festgelegt, wird ein Fehler zurückgegeben.

Type:	EnhancedTimeSpan
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

-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 oder die GUID des verwalteten Ordners an, für den die Einstellungen für verwaltete Inhalte gelten.

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

-JournalingEnabled

Der Parameter JournalingEnabled gibt an, dass die Journalfunktion aktiviert ist, wenn er auf $true festgelegt ist.

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

-LabelForJournaling

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.

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

-MessageClass

Der Parameter MessageClass gibt den Nachrichtentyp an, auf den sämtliche Konfigurationseinstellungen für Ablauf- und Journalfunktion in diesen Inhaltseinstellungen angewendet werden.

Der Parameterwert kann ein bekannter Nachrichtentyp, z. B. Kalenderelemente, eine bestimmte Nachrichtenklasse sein, z. B. IPM.NOTE.SMIME, oder eine benutzerdefinierte Nachrichtenklasse. Die folgenden bekannten Nachrichtentypen können verwendet werden:

• 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 Journalelemente 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*.

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 Sternchen als Platzhalterzeichen aufweist. Das Sternchen muss als letztes Zeichen in der Nachrichtenklasse angezeigt werden. Beispiel: IPM. HINWEIS* (enthält IPM. HINWEIS und alle Unterklassen) oder IPM. HINWEIS.* (enthält die Unterklassen für IPM. HINWEIS, aber nicht IPM. HINWEIS selbst). *. HINWEIS und IPM.*. HINWEIS sind keine gültigen Werte.

Hinweise:

• Wenn Platzhalterzeichen verwendet werden, gelten diese Richtlinien nur für Nachrichtenklassen, die keine bestimmte Inhaltseinstellung aufweisen. Daher wird IPM.NOTE.* von IPM.NOTE.SMIME außer Kraft gesetzt.
• Bestimmte Einstellungen ersetzt allgemeine Einstellungen, z. B. ersetzt Voicemail AllMailboxContent.

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

-MessageFormatForJournaling

Der Parameter MessageFormatForJournaling gibt das Nachrichtenformat an, das für ein Element im Journal verwendet werden soll. Folgende Werte können verwendet werden:

• UseMsg Outlook .msg format
• Verwenden des Outlook-MAPI-Formats

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

-MoveToDestinationFolder

Der Parameter MoveToDestinationFolder gibt den Zielordner für einen Verschiebungsvorgang an.

Der Zielordner muss ein vorhandener, verwalteter, benutzerdefinierter Ordner sein. Ist dies nicht der Fall, wird ein Fehler zurückgegeben. Wenn der Parameter MoveToDestinationFolder nicht angegeben und der Wert des Parameters RetentionAction auf MoveToFolder festgelegt ist, wird ein Fehler zurückgegeben.

Type:	ELCFolderIdParameter
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 die Einstellungen für verwaltete Inhalte an.

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

-RetentionAction

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 auf $true festgelegt, wird ein Fehler zurückgegeben.

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

-RetentionEnabled

Der Parameter RetentionEnabled gibt an, dass die Aufbewahrung aktiviert ist, wenn er auf $true festgelegt ist.

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

-TriggerForRetention

Der Parameter TriggerForRetention gibt das Datum an, das als Startdatum für den Aufbewahrungszeitraum angenommen wird. Ein Element kann sein Aufbewahrungslimit nach einer bestimmten Anzahl von Tagen erreichen, nachdem das Element zugestellt wurde oder nachdem es in einen Ordner verschoben wurde.

Gültige Werte sind:

• WhenDelivered
• WhenMoved

Dieser Wert entspricht dem 0x4 Bit des Attributs msExchELCFlags in Active Directory. Das Flag wird auf $true festgelegt, wenn der Artikel basierend auf dem Datum, an dem er verschoben wurde, abläuft, und $false, wenn der Artikel basierend auf dem Lieferdatum abläuft.

Wird dieser Parameter nicht angegeben und der Parameter RetentionEnabled auf $true festgelegt, wird ein Fehler zurückgegeben.

Type:	RetentionDateType
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.