Set-QuarantinePermissions

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Set-QuarantinePermissions, um Objekte für Quarantäneberechtigungen zu ändern, die in Quarantänetags (New-QuarantineTag- oder Set-QuarantineTag-Cmdlets) verwendet werden. Dieses Cmdlet funktioniert nur für Berechtigungsobjekte, die vom Cmdlet New-QuarantinePermissions erstellt und in einer Variablen gespeichert wurden, die derzeit in der Windows PowerShell-Sitzung verfügbar ist.

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

Syntax

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

Beschreibung

Um den aktuellen Wert des Berechtigungsobjekts anzuzeigen, das Sie ändern möchten, führen Sie den Variablennamen als Befehl aus. Führen Sie beispielsweise den Befehl aus $Perms , um die in der Variablen gespeicherten Berechtigungen des Quarantänetags $Perms anzuzeigen.

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-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

In diesem Beispiel werden die angegebenen Quarantänetagberechtigungen im beendenden $Perms Berechtigungsobjekt geändert, das zuvor in derselben Windows PowerShell Sitzung erstellt wurde (die $Perms Variable ist weiterhin verfügbar und aufgefüllt).

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

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

-QuarantinePermissionsObject

Der Parameter QuarantinePermissionsObject gibt die Variable an, die das Zu ändernde Quarantäneberechtigungsobjekt enthält. Wenn Sie beispielsweise den Befehl $Perms = New-QuarantinePermissions <permissions>ausgeführt haben, verwenden Sie den Wert $Perms für diesen Parameter.

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