New-QuarantinePermissions

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet New-QuarantinePermissions, um Quarantäneberechtigungsobjekte für die Verwendung mit dem Cmdlet New-QuarantineTag zu erstellen.

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

Syntax

New-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Beschreibung

Der Standardwert für alle Parameter, die Sie nicht verwenden, ist $false, sodass Sie nur Parameter (Berechtigungen) verwenden müssen, die Sie auf $true festlegen möchten.

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

$NoAccess = New-QuarantinePermissions

In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe Keine Zugriffsberechtigungen in Quarantänetags in der Sicherheitskonformität & verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $NoAccessgespeichert.

In derselben Windows PowerShell Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantineTag- oder Set-QuarantineTag-Befehl verwenden$NoAccess.

Beispiel 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe Eingeschränkte Zugriffsberechtigungen in Quarantänetags in der Sicherheitskonformität & verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $LimitedAccessgespeichert.

In derselben Windows PowerShell Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantineTag- oder Set-QuarantineTag-Befehl verwenden$LimitedAccess.

Beispiel 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe Vollzugriffsberechtigungen in Quarantänetags in der Sicherheitskonformität & verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $FullAccessgespeichert.

In derselben Windows PowerShell Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantineTag- oder Set-QuarantineTag-Befehl verwenden$FullAccess.

Parameter

-PermissionToBlockSender

Der Parameter PermissionToBlockSender gibt an, ob Benutzer den in Quarantäne befindlichen Nachrichtensender ihrer Liste blockierter Absender hinzufügen dürfen. Gültige Werte sind:

  • $true: Die Schaltfläche Absender blockieren ist in quarantänebenachrichtigungen für Endbenutzer enthalten.
  • $false: Die Schaltfläche Absender blockieren ist in den Quarantänebenachrichtigungen von Endbenutzern nicht enthalten. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDelete

Der Parameter PermissionToDelete gibt an, ob Benutzer Nachrichten aus der Quarantäne löschen dürfen. Gültige Werte sind:

  • $true: Die Schaltfläche Aus Quarantäne entfernen ist in den Details der unter Quarantäne liegenden Nachricht enthalten.
  • $false: Die Schaltfläche Aus Quarantäne entfernen ist nicht in den Details der isolierten Nachricht enthalten. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDownload

Der Parameter PermissionToDownload gibt an, ob Benutzer Nachrichten aus der Quarantäne herunterladen dürfen. Gültige Werte sind:

  • $true: Die Berechtigung ist aktiviert.
  • $false: Die Berechtigung ist deaktiviert. Dies ist der Standardwert.

Derzeit hat dieser Wert keine Auswirkungen auf die Schaltflächen, die in Spam-Benachrichtigungen von Endbenutzern oder in den Details zu unter Quarantäne liegenden Nachrichten enthalten sind.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToPreview

Der Parameter PermissionToPreview gibt an, ob Benutzer eine Vorschau der in Quarantäne befindlichen Nachrichten anzeigen dürfen. Gültige Werte sind:

  • $true: Die Schaltfläche Nachrichtenvorschau ist in den Details der isolierten Nachricht enthalten.
  • $false: Die Schaltfläche "Nachrichtenvorschau" ist nicht in den Details der isolierten Nachricht enthalten. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToRelease

Der Parameter PermissionToRelease gibt an, ob Benutzer nachrichten direkt aus der Quarantäne freigeben dürfen. Gültige Werte sind:

  • $true: Die Schaltfläche Freigeben ist in spam-Benachrichtigungen von Endbenutzern enthalten, und die Schaltfläche Nachricht freigeben ist in den unter Quarantäne liegenden Nachrichtendetails enthalten.
  • $false: Die Schaltfläche Freigeben ist in den Spambenachrichtigungen von Endbenutzern nicht enthalten, und die Schaltfläche Nachricht freigeben ist nicht in den Details der isolierten Nachricht enthalten. Dies ist der Standardwert.

Legen Sie diesen Parameter und den Parameter PermissionToRequestRelease nicht auf $true fest. Legen Sie einen Parameter auf $true und den anderen auf $false fest, oder legen Sie beide Parameter auf $false fest.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToRequestRelease

Der Parameter PermissionToRequestRelease gibt an, ob Benutzer die Freigabe von Nachrichten aus der Quarantäne anfordern dürfen. Die Anforderung muss von einem Administrator genehmigt werden. Gültige Werte sind:

  • $true: Die Schaltfläche Freigeben ist in spam-Benachrichtigungen von Endbenutzern enthalten, und die Schaltfläche Nachricht freigeben ist in den unter Quarantäne liegenden Nachrichtendetails enthalten.
  • $false: Die Schaltfläche Freigeben ist in den Spambenachrichtigungen von Endbenutzern nicht enthalten, und die Schaltfläche Nachricht freigeben ist nicht in den Details der isolierten Nachricht enthalten. Dies ist der Standardwert.

Legen Sie diesen Parameter und den Parameter PermissionRelease nicht auf $true fest. Legen Sie einen Parameter auf $true und den anderen auf $false fest, oder legen Sie beide Parameter auf $false fest.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToViewHeader

Der PermissionToViewHeader-Parameter gibt an, ob Benutzer die Nachrichtenheader von in Quarantäne befindlichen Nachrichten anzeigen dürfen. Gültige Werte sind:

  • $true: Die Berechtigung ist aktiviert.
  • $false: Die Berechtigung ist deaktiviert. Dies ist der Standardwert.

Derzeit hat dieser Wert keine Auswirkungen auf die Schaltflächen, die in Spam-Benachrichtigungen von Endbenutzern oder in den Details zu unter Quarantäne liegenden Nachrichten enthalten sind. Die Schaltfläche Nachrichtenkopfzeile anzeigen ist in den unter Quarantäne gestellten Nachrichtendetails immer verfügbar.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection