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 0

In 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