New-QuarantinePolicy
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet New-QuarantinePolicy, um Quarantänerichtlinien in Ihrer cloudbasierten organization zu erstellen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>] Beschreibung
Mithilfe von Quarantänerichtlinien wird definiert, welche Aktionen Benutzer mit unter Quarantäne bezogenen Nachrichten ausführen dürfen, basierend auf dem Grund, warum die Nachricht unter Quarantäne gesetzt wurde (für unterstützte Features) und Quarantänebenachrichtigungseinstellungen. Weitere Informationen finden Sie unter Quarantänerichtlinien.
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-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0In diesem Beispiel wird eine neue Quarantänerichtlinie mit dem Namen ContosoTag mit den gleichen Berechtigungen wie die Berechtigungsgruppe Kein Zugriff voreingestellt erstellt.
Verwenden Sie den Wert 27, um eingeschränkte Zugriffsberechtigungen zuzuweisen. Verwenden Sie zum Zuweisen von Vollzugriffsberechtigungen den Wert 23.
Parameter
-AdminDisplayName
Der Parameter AdminDisplayName gibt eine Beschreibung für die Quarantänerichtlinie an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationFrequencyInDays
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationLanguage
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | EsnLanguage |
| Accepted values: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationsEnabled
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminQuarantinePermissionsList
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CustomDisclaimer
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DomainController
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissions
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | QuarantinePermissions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissionsValue
Der Parameter EndUserQuarantinePermissionsValue gibt die Endbenutzerberechtigungen für die Quarantänerichtlinie an.
Dieser Parameter verwendet einen Dezimalwert, der aus einem Binärwert konvertiert wird. Der Binärwert entspricht der Liste der verfügbaren Berechtigungen in einer bestimmten Reihenfolge. Für jede Berechtigung ist der Wert 1 gleich True und der Wert 0 gleich False. Die erforderliche Reihenfolge wird in der folgenden Liste von der höchsten (1000000 oder 128) bis zur niedrigsten Reihenfolge (00000001 oder 1) beschrieben:
- PermissionToViewHeader: Der Wert 0 blendet die Aktion Nachrichtenheader anzeigen in Quarantäne nicht aus. Wenn die Nachricht in Quarantäne angezeigt wird, ist die Aktion für die Nachricht immer verfügbar.
- PermissionToDownload: Diese Berechtigung wird nicht verwendet (der Wert 0 oder 1 bewirkt nichts).
- PermissionToAllowSender: Diese Berechtigung wird nicht verwendet (der Wert 0 oder 1 bewirkt nichts).
- PermissionToBlockSender
- PermissionToRequestRelease: Legen Sie diese Berechtigung und PermissionToRelease nicht auf den Wert 1 fest. Legen Sie einen Wert auf 1 und den anderen wert auf 0 fest, oder legen Sie beide Werte auf 0 fest.
- PermissionToRelease: Legen Sie diese Berechtigung und PermissionToRequestRelease nicht auf den Wert 1 fest. Legen Sie einen Wert auf 1 und den anderen wert auf 0 fest, oder legen Sie beide Werte auf 0 fest. Diese Berechtigung wird nicht für Nachrichten berücksichtigt, die als Schadsoftware oder Phishing mit hoher Zuverlässigkeit unter Quarantäne gesetzt wurden. Wenn die Quarantänerichtlinie Benutzern diese Berechtigung erteilt, dürfen Benutzer die Freigabe ihrer unter Quarantäne gestellten Schadsoftware oder Phishingnachrichten mit hoher Zuverlässigkeit anfordern, als ob stattdessen PermissionToRequestRelease ausgewählt wäre.
- PermissionToPreview
- PermissionToDelete
Die Werte für die voreingestellten Endbenutzerberechtigungsgruppen werden in der folgenden Liste beschrieben:
- Kein Zugriff: Binary = 0000000, verwenden Sie daher den Dezimalwert 0.
- Eingeschränkter Zugriff: Binary = 00011011. Verwenden Sie daher den Dezimalwert 27.
- Vollzugriff: Binär = 00010111. Verwenden Sie daher den Dezimalwert 23.
Rufen Sie für benutzerdefinierte Berechtigungen den Binärwert ab, der den gewünschten Berechtigungen entspricht. Konvertieren Sie den Binärwert in einen zu verwendenden Dezimalwert. Verwenden Sie nicht den Binärwert für diesen Parameter.
Hinweis: Wenn der Wert dieses Parameters $true ist und der Wert des EndUserQuarantinePermissionsValue-Parameters 0 (Kein Zugriff, bei dem alle Berechtigungen deaktiviert sind), können Benutzer ihre Nachrichten in Quarantäne anzeigen, aber die einzige verfügbare Aktion für die Nachrichten ist Nachrichtenkopfzeile anzeigen.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationCustomFromAddress
EndUserSpamNotificationCustomFromAddress gibt die E-Mail-Adresse eines vorhandenen internen Absenders an, der als Absender für Quarantänebenachrichtigungen verwendet werden soll.
Wenn Sie diesen Parameter nicht verwenden, ist quarantine@messaging.microsoft.comder Standardsender .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequency
Der Parameter EndUserSpamNotificationFrequency gibt an, wie oft Quarantänebenachrichtigungen an Benutzer gesendet werden. Gültige Werte sind:
- 04:00:00 (4 Stunden)
- 1.00:00:00 (1 Tag)
- 7.00:00:00 (7 Tage)
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequencyInDays
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationLanguage
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | EsnLanguage |
| Accepted values: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EsnCustomSubject
Der Parameter EsnCustomSubject gibt den Text an, der im Feld Betreff der Quarantänebenachrichtigungen verwendet werden soll.
Sie können mehrere Werte angeben, die durch Kommas getrennt sind, indem Sie die folgende Syntax verwenden: ('value1',''value2',...'valueN'). Für jede Sprache, die Sie mit dem MultiLanguageSetting-Parameter angeben, müssen Sie eindeutigen Absendertext angeben. Achten Sie darauf, die entsprechenden MultiLanguageSetting-, MultiLanguageCustomDisclaimer-, EsnCustomSubject- und MultiLanguageSenderName-Parameterwerte in derselben Reihenfolge auszurichten.
Um einen vorhandenen Wert zu ändern und andere Werte beizubehalten, müssen Sie alle vorhandenen Werte und den neuen Wert in der vorhandenen Reihenfolge angeben.
Diese Einstellung ist nur in der integrierten Quarantänerichtlinie defaultGlobalTag verfügbar, die die Einstellungen der globalen Quarantänerichtlinie steuert. Um auf diese Quarantänerichtlinie zuzugreifen, starten Sie den Befehl mit der folgenden Syntax: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | undefined |
| Aliases: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ESNEnabled
Der PARAMETER ESNEnabled gibt an, ob Quarantänebenachrichtigungen (früher als Spambenachrichtigungen für Endbenutzer bezeichnet) für die Richtlinie aktiviert werden sollen. Gültige Werte sind:
- $true: Quarantänebenachrichtigungen sind aktiviert.
- $false: Quarantänebenachrichtigungen sind deaktiviert. Der Benutzer kann nur auf in Quarantäne befindliche Nachrichten zugreifen, nicht in E-Mail-Benachrichtigungen. Dies ist der Standardwert.
Hinweis: Wenn der Wert dieses Parameters $true ist und der Wert des EndUserQuarantinePermissionsValue-Parameters 0 (Kein Zugriff, bei dem alle Berechtigungen deaktiviert sind), können Benutzer ihre Nachrichten in Quarantäne sehen, aber die einzige verfügbare Aktion für die Nachrichten ist Nachrichtenkopfzeile anzeigen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSenderName
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSetting
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Der Parameter Name gibt einen eindeutigen Namen für die Quarantänerichtlinie an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-QuarantinePolicyType
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | QuarantinePolicyType |
| Accepted values: | QuarantinePolicy, GlobalQuarantinePolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-QuarantineRetentionDays
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |