Get-InboxRule

 

Gilt für:Exchange Online, Exchange Server 2016

Letztes Änderungsdatum des Themas:2018-01-16

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 Cmdlet Get-InboxRule, um Eigenschaften von Posteingangsregeln anzuzeigen. Posteingangsregeln werden verwendet, um Nachrichten im Posteingang nach angegebenen Bedingungen zu verarbeiten und Aktionen wie das Verschieben einer Nachricht in einen bestimmten Ordner oder das Löschen einer Nachricht auszuführen.

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

Get-InboxRule [-Identity <InboxRuleIdParameter>] [-DescriptionTimeFormat <String>] [-DescriptionTimeZone <ExTimeZoneValue>] [-DomainController <Fqdn>] [-IncludeHidden <SwitchParameter>] [-Mailbox <MailboxIdParameter>]

In diesem Beispiel werden alle Posteingangsregeln für das Postfach "Joe@Contoso.com" abgerufen.

Get-InboxRule -Mailbox Joe@Contoso.com

In diesem Beispiel wird die Posteingangsregel ReceivedLastYear aus dem Postfach "joe@contoso.com" abgerufen, für das bei Erstellung der Regel der Parameter ReceivedBeforeDate festgelegt wurde. Die Parameter DescriptionTimeFormat und DescriptionTimeZone dienen in diesem Beispiel zum Angeben des Uhrzeitformats und der Zeitzone, die in der Eigenschaft Description der Regel verwendet werden.

Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Posteingangsregeln" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

DescriptionTimeFormat

Optional

System.String

Der Parameter DescriptionTimeFormat gibt das Format an, in dem Zeitwerte in der Regelbeschreibung zurückgegeben werden. Sie müssen Standardeinstellungen für das Datums- und Uhrzeitformat verwenden, z. B.:

mm/tt/jjjj, wobei mm der zweistelligen Monatsangabe, tt der zweistelligen Tagesangabe und jjjj der vierstelligen Jahresangabe entspricht.

DescriptionTimeZone

Optional

Microsoft.Exchange.Data.Storage.Management.ExTimeZoneValue

Der Parameter DescriptionTimeZone gibt das Format an, in dem die Zeitzone für Zeitwerte in der Regelbeschreibung zurückgegeben wird. Verwenden Sie den Namen einer gültigen Microsoft Windows-Zeitzone.

Mit der Befehlszeilenschnittstelle von Windows PowerShell können Sie die Namen von Zeitzonen aus der Registrierung abrufen, z. B.:

$timezone = Get-ChildItem "HKLM :\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | For-Each {Get-ItemProperty $_.PSPath}; $timezone | Format-Table pschildname,display -auto

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.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.InboxRuleIdParameter

Der Parameter Identity gibt die Identität der Posteingangsregel an.

IncludeHidden

Optional

System.Management.Automation.SwitchParameter

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

Mailbox

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Mailbox gibt das Postfach an, zu dem die Posteingangsregel gehört. Einer der folgenden Werte kann verwendet werden:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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: