Set-ManagedContentSettings
Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.
Verwenden Sie das Cmdlet Set-ManagedContentSettings, um vorhandene Einstellungen für verwaltete Inhalte für einen verwalteten Ordner zu ändern.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Set-ManagedContentSettings
[-Identity] <ELCContentSettingsIdParameter>
[-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>]
[-Confirm]
[-DomainController <Fqdn>]
[-JournalingEnabled <Boolean>]
[-LabelForJournaling <String>]
[-MessageFormatForJournaling <JournalingFormat>]
[-MoveToDestinationFolder <ELCFolderIdParameter>]
[-Name <String>]
[-RetentionAction <RetentionAction>]
[-RetentionEnabled <Boolean>]
[-TriggerForRetention <RetentionDateType>]
[-WhatIf]
[<CommonParameters>]
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. Weitere Informationen zu den Einstellungen für verwaltete Inhalte finden Sie unter Messaging-Datensatzverwaltung.
Auch wenn das Cmdlet New-ManagedContentSettings den Parameter MessageClass enthält, ist das beim Cmdlet Set-ManagedContentSettings nicht der Fall. Wenn Sie den Nachrichtentyp ändern möchten, auf den die Einstellungen für Inhalte angewendet werden sollen, müssen Sie die Einstellungen für Inhalte löschen und anschließend neu erstellen. Weitere Informationen zum Parameter MessageClass finden Sie unter New-ManagedContentSettings.
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
Set-ManagedContentSettings -Identity MyManagedContentSettings -AddressForJournaling MySmtpAddress@contoso.com
In diesem Beispiel wird die Adresse des Journalempfängers angegeben, der das Ziel von Journaloperationen ist.
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
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 Altersgrenze entspricht der Anzahl von Tagen ab dem Datum, an dem der Artikel geliefert wurde, oder dem Datum, an dem ein Artikel erstellt wurde, wenn er nicht geliefert 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 |
-Identity
Der Parameter Identity gibt den Namen, den DN (Distinguished Name) oder die GUID der verwalteten Inhaltseinstellungen an.
Type: | ELCContentSettingsIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-MessageFormatForJournaling
Der Parameter MessageFormatForJournaling gibt das Format an, das für ein Element im Journal verwendet werden soll. Folgende Werte können verwendet werden:
- Verwenden SieMsg Microsoft 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 Namen des Zielordners für eine Aufbewahrungsaktion an.
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RetentionAction
Der Parameter RetentionAction gibt eine der folgenden Aktionen an, die ausgeführt werden, wenn ein Element die im Parameter AgeLimitForRetention angegebene Verfallszeit für die Aufbewahrung erreicht. Die folgenden Aufbewahrungsaktionen können verwendet werden:
- 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 Aufbewahrungsfunktion 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 des Aufbewahrungszeitraums erachtet 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.
Folgende Werte sind u. a. gültig:
- WhenDelivered Der Artikel läuft ab, je nachdem, wann er geliefert wurde.
- WhenMoved Das Element läuft basierend auf dem Datum ab, an dem es verschoben wurde.
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.