Set-SweepRule

Exchange 2016
 

Letztes Änderungsdatum des Themas:2018-01-11

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im Cloud-basierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Set-SweepRule-Cmdlet, um Aufräumregel in Postfächern zu ändern.

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

Set-SweepRule -Identity <SweepRuleIdParameter> [-DestinationFolder <MailboxFolderIdParameter>] [-Enabled <$true | $false>] [-ExceptIfFlagged <$true | $false>] [-ExceptIfPinned <$true | $false>] [-KeepForDays <Int32>] [-KeepLatest <Int32>] [-Name <String>] [-Provider <String>] [-Sender <RecipientIdParameter>] [-SourceFolder <MailboxFolderIdParameter>] [-SystemCategory <NotDefined | FromContact | Newsletter | Photo | SocialUpdate | Video | Document | File | MailingList | ShippingNotification | LiveView | DocumentPlus | Important | Family | Bills | Shopping | Travel | Flight | RestaurantReservation | Lodging | RentalCar | Purchase | Event | RetiredPromotion>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]

In diesem Beispiel wird für die vorhandene Regel mit dem Regel-ID-Wert x2hlsdpGmUifjFgxxGIOJw== der Wert zu dem angegebenen Wert geändert.

Set-SweepRule -Identity x2hlsdpGmUifjFgxxGIOJw== -KeepForDays 15 -ExceptIfPinned $true

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. Informationen über das Suchen nach den für das Ausführen von Cmdlets oder Parametern in Ihrer Organisation erforderlichen Berechtigungen finden Sie unter Ermitteln der erforderlichen Berechtigungen zum Ausführen von Exchange-Cmdlets.

 

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.SweepRuleIdParameter

Der Parameter Identity gibt die Aufräumregel an, die Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der die Regel eindeutig identifiziert. Beispiel:

  • RuleId-Eigenschaft (z. B. x2hlsdpGmUifjFgxxGIOJw==).

  • Identity-Eigenschaft im Format <mailbox>\<RuleIdentity>:

    • Exchange Online: <mailbox alias>\<RuleId> (zum Beispiel rzaher\x2hlsdpGmUifjFgxxGIOJw==.

    • Lokale Exchange-Umgebung: <mailbox canonical name>\<RuleId> (z. B. contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==.

Sie können diese Identitätswerte mithilfe des Get-SweepRule-Cmdlets abrufen.

Confirm

Optional

System.Management.Automation.SwitchParameter

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

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pausefunktion, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie mithilfe der exakt folgenden Syntax die Bestätigungsaufforderung überspringen: -Confirm:$false.

  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pausefunktion. Bei diesen Cmdlets führt das Angeben des Confirm-Switches ohne einen Wert eine Pausefunktion ein, wodurch Sie gezwungen werden, den Befehl zu bestätigen, bevor Sie fortfahren.

DestinationFolder

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Der Parameter DestinationFolder gibt eine Aktion für die Aufräumregel an, die Nachrichten in den angegebenen Ordner auf Grundlage der Bedingungen der Regel verschiebt.

Der Standardwert ist Deleted Items.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist nur in der lokalen Exchange-Bereitstellung verfügbar.

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. Zum Beispiel dc01.contoso.com.

Enabled

Optional

System.Boolean

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

ExceptIfFlagged

Optional

System.Boolean

Der ExceptIfFlagged-Parameter gibt eine Ausnahme für die Aufräumregel an, die nach Nachrichten mit Nachrichtenkennzeichnungen sucht. Gültige Werte sind:

  • $true   Die Regelaktion wird nicht auf Nachrichten mit Nachrichtenkennzeichnungen angewendet.

  • $false   Die Ausnahme wird nicht verwendet.

Übliche Nachrichtenkennzeichnungswerte sind:

  • Any

  • Call

  • DoNotForward

  • FollowUp

  • ForYourInformation

  • Forward

  • NoResponseNecessary

  • Read

  • Reply

  • ReplyToAll

  • Review

ExceptIfPinned

Optional

System.Boolean

Der PinMessage-Parameter gibt eine Ausnahme für die Aufräumregel an, die nach angehefteten Nachrichten sucht. Gültige Werte sind:

  • $true   Die Regelaktion wird nicht auf Nachrichten angewendet, die oben im Posteingang angeheftet sind.

  • $false   Die Ausnahme wird nicht verwendet.

KeepForDays

Optional

System.Int32

Der Parameter KeepForDays gibt eine Aktion für die Aufräumregel an, die die Anzahl der Tage für die Aufbewahrung von Nachrichten auf Grundlage der Bedingungen der Regel angibt. Nachdem diese Zeit verstrichen ist, werden die Nachrichten in den Ordner verschoben, der im DestinationFolder-Parameter angegeben ist (Standardmäßig der Ordner „Gelöschte Elemente“).

Sie können diesen Parameter nicht mit dem KeepLatest-Parameter verwenden, und die Aufräumregel muss einen KeepForDays- oder KeepLatest-Parameterwert enthalten.

KeepLatest

Optional

System.Int32

Der Parameter KeepLatest gibt eine Aktion für die Aufräumregel an, die die Anzahl der aufzubewahrenden Nachrichten auf Grundlage der Bedingungen der Regel angibt. Wenn diese Anzahl überschritten wird, werden die ältesten Nachrichten in den Ordner verschoben, der im DestinationFolder-Parameter angegeben ist (Standardmäßig der Ordner „Gelöschte Elemente“).

Sie können diesen Parameter nicht mit dem KeepForDays-Parameter verwenden, und die Aufräumregel muss einen KeepForDays- oder KeepLatest-Parameterwert enthalten.

Mailbox

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Mailbox-Parameter gibt das Postfach an, das die zu ändernde Regel enthält. Sie können einen beliebigen Wert verwenden, der das Postfach eindeutig identifiziert.

Beispiel:

  • Name

  • Anzeigename

  • Alias

  • Distinguished Name (DN)

  • Kanonischer DN

  • <domain name>\<account name>

  • E-Mail-Adresse

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Benutzer-ID oder User Principal Name (UPN)

Name

Optional

System.String

Der Parameter Name gibt den Namen der Aufräumregel an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Provider

Optional

System.String

Der Provider-Parameter gibt den Anbieter für die Aufräumregel an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen.

Der Standardwert für Aufräumregeln, die Sie in Outlook im Web erstellen, lautet Exchange16.

Sender

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Der Parameter Sender gibt eine Bedingung für die Aufräumregel an, die nach angegebenen Absendern in Nachrichten sucht. Sie können für interne Absender einen beliebigen Wert verwenden, der den Absender eindeutig identifiziert.

Beispiel:

  • Name

  • Anzeigename

  • Alias

  • Distinguished Name (DN)

  • Kanonischer DN

  • E-Mail-Adresse

  • GUID

Verwenden Sie für externe Absender die entsprechenden E-Mail-Adressen.

SourceFolder

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Der Parameter SourceFolder gibt eine Bedingung für die Aufräumregel an, die Nachrichten im angegebenen Ordner durchsucht.

Der Standardwert ist Inbox.

SystemCategory

Optional

Microsoft.Exchange.Data.SystemCategoryType

Der Parameter SystemCategory gibt eine Bedingung für die Aufräumregel an, die nach Nachrichten mit der angegebenen Systemkategorie sucht. Systemkategorien stehen für alle Postfächer in der Organisation zur Verfügung. Gültige Werte sind:

  • NotDefined

  • Bills

  • Document

  • DocumentPlus

  • Event

  • Family

  • File

  • Flight

  • FromContact

  • Important

  • LiveView

  • Lodging

  • MailingList

  • Newsletter

  • Photo

  • Purchase

  • RentalCar

  • RestaurantReservation

  • RetiredPromotion

  • ShippingNotification

  • Shopping

  • SocialUpdate

  • Travel

  • Video

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Switch 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.

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.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: