Set-OutlookProtectionRule
Hinweis: Dieses Cmdlet wird im cloudbasierten Dienst nicht mehr unterstützt.
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.
Verwenden Sie das Cmdlet Set-OutlookProtectionRule, um eine vorhandene Microsoft Outlook-Schutzregel zu ändern.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Set-OutlookProtectionRule
[-Identity] <RuleIdParameter>
[-ApplyRightsProtectionTemplate <RmsTemplateIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-FromDepartment <String[]>]
[-Name <String>]
[-Priority <Int32>]
[-SentTo <MultiValuedProperty>]
[-SentToScope <ToUserScope>]
[-UserCanOverride <Boolean>]
[-WhatIf]
[<CommonParameters>] Beschreibung
Outlook-Schutzregeln werden verwendet, um E-Mail-Nachrichten mithilfe einer RMS-Vorlage (Rights Management Services) automatisch mit Rechten zu schützen, bevor die Nachricht gesendet wird. Outlook-Schutzregeln überprüfen den Nachrichteninhalt jedoch nicht. Verwenden Sie Transportschutzregeln zum Schutz von Nachrichten durch Rechte basierend auf dem Nachrichteninhalt. Weitere Informationen finden Sie unter Outlook-Schutzregeln.
Wenn Keine Bedingungen angegeben werden, wird eine Outlook-Schutzregel auf alle Nachrichten angewendet.
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-OutlookProtectionRule -Identity "OPR-DG-Finance" -SentTo "DG-Finance"In diesem Beispiel wird die Outlook-Schutzregel OPR-DG-Finance so geändert, dass sie auf Nachrichten angewendet wird, die an die DG-Finance Verteilergruppe gesendet werden.
Beispiel 2
Set-OutlookProtectionRule -Identity "OPR-DG-Finance" -Priority 2In diesem Beispiel wird die Priorität der Outlook-Schutzregel OPR-DG-Finance auf 2 festgelegt.
Parameter
-ApplyRightsProtectionTemplate
Der Parameter ApplyRightsProtectionTemplate gibt eine RMS-Vorlage an, die auf Nachrichten angewendet werden soll, die die Bedingungen erfüllen.
| Type: | RmsTemplateIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Dieser Parameter ist im lokalen Exchange 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. 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Verwenden Sie diesen Schalter, um die Bestätigungsaufforderung zu unterdrücken, die angezeigt wird, wenn Sie eine Regel ohne Bedingungen ändern (die Regel gilt für alle Nachrichten).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FromDepartment
Der Parameter FromDepartment gibt den Abteilungsnamen an. Die Regel wird auf die Nachricht angewendet, wenn das Abteilungsattribut des Absenders diesem Wert entspricht.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Der Parameter Identity gibt die Regel an.
| Type: | RuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Der Parameter Name gibt einen Namen für die Regel an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
Der Parameter Priority gibt eine Priorität für die Outlook-Schutzregel an. Regelprioritätswerte können zwischen 0 und n bis 1 liegen, wobei n die Gesamtzahl der vorhandenen Outlook-Schutzregeln ist.
Die Priorität vorhandener Regeln, deren Priorität der festgelegten Priorität entspricht oder diese überschreitet, wird um 1 erhöht.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentTo
Der Parameter SentTo gibt mindestens einen Empfänger an. Externe Empfänger können mithilfe der SMTP-Adresse angegeben werden.
Interne Empfänger können mithilfe der folgenden Werte angegeben werden:
- Alias
- Distinguished Name (DN)
- ExchangeGUID
- LegacyExchangeDN
- SmtpAddress
- Benutzerprinzipalname (User Principal Name, UPN)
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentToScope
Der Parameter SentToScope gibt den Bereich von Nachrichten an, für die die Regel gilt. Gültige Werte sind:
- Alle: Gilt für alle Nachrichten.
- InOrganization: Gilt für Nachrichten, die aus der Exchange-Organisation stammen, wobei alle Empfänger auch intern sind.
Wenn kein Wert festgelegt wird, wird der Parameter standardmäßig auf All festgelegt.
| Type: | ToUserScope |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UserCanOverride
Der Parameter UserCanOverride gibt an, ob der Outlook-Benutzer das Regelverhalten außer Kraft setzen kann, entweder mithilfe einer anderen RMS-Vorlage oder durch Entfernen des Rechteschutzes vor dem Senden der Nachricht. Gültige Werte sind:
- $true: Der Benutzer kann die Regelaktion außer Kraft setzen.
- $false: Der Benutzer kann die Regelaktion nicht außer Kraft setzen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.