Set-QuarantinePermissions

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Hinweis: Anstatt dieses Cmdlet zum Festlegen von Quarantänerichtlinienberechtigungen zu verwenden, empfehlen wir, den Parameter EndUserQuarantinePermissionsValue für die Cmdlets New-QuarantinePolicy und Set-QuarantinePolicy zu verwenden.

Verwenden Sie das Cmdlet Set-QuarantinePermissions, um Objekte mit Quarantäneberechtigungen zu ändern, die von der New-QuarantinePermissions erstellt und in der aktuellen PowerShell-Sitzung als Variable gespeichert wurden. Sie verwenden die Variable als Wert für den Parameter EndUserQuarantinePermission im New-QuarantinePolicy- oder Set-QuarantinePolicy-Cmdlet in derselben PowerShell-Sitzung.

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

Syntax

Default (Standard)

Set-QuarantinePermissions
    -QuarantinePermissionsObject <QuarantinePermissions>
    [[-PermissionToAllowSender] <Boolean>]
    [[-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 $Perms aus, um die in der $Perms Variablen gespeicherten Quarantänerichtlinienberechtigungen anzuzeigen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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 Berechtigungen für die Quarantänerichtlinie in der vorhandenen $Perms Variablen geändert, die zuvor mithilfe des Cmdlets New-QuarantinePermissions in derselben PowerShell-Sitzung erstellt wurde (die $Perms Variable ist weiterhin verfügbar und aufgefüllt).

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

Parameter

-PermissionToAllowSender

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Parameter PermissionToBlockSender gibt an, ob Benutzer den unter Quarantäne gestellten Absender ihrer Liste sicherer Absender hinzufügen dürfen. Gültige Werte sind:

  • $true: Absender zulassen ist für betroffene Nachrichten in Quarantäne verfügbar.
  • $false: Absender zulassen ist für betroffene Nachrichten in Quarantäne nicht verfügbar. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToBlockSender

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

  • $true: "Absender blockieren" ist in den Quarantänebenachrichtigungen für betroffene Nachrichten verfügbar, und "Absender blockieren" ist für betroffene Nachrichten in Quarantäne verfügbar.
  • $false: "Absender blockieren" ist in den Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und "Absender blockieren" ist für betroffene Nachrichten in der Quarantäne nicht verfügbar. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToDelete

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

  • $true: "Nachrichten löschen" und "Aus Quarantäne löschen" sind für betroffene Nachrichten in der Quarantäne verfügbar.
  • $false: "Nachrichten löschen" und "Aus Quarantäne löschen" sind für betroffene Nachrichten in der Quarantäne nicht verfügbar. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToDownload

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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. Dieser Wert ist der Standardwert.

Derzeit hat dieser Wert keine Auswirkungen auf die verfügbaren Aktionen in Quarantänebenachrichtigungen oder Quarantäne für betroffene Nachrichten. Endbenutzer können keine unter Quarantäne gestellten Nachrichten herunterladen.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToPreview

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

  • $true: Für betroffene Nachrichten in Quarantäne ist eine Vorschau der Nachricht verfügbar.
  • $false: Für betroffene Nachrichten in Quarantäne ist keine Nachrichtenvorschau verfügbar. Dieser Wert ist der Standardwert.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToRelease

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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

  • $true: Die Freigabe ist in den Quarantänebenachrichtigungen für betroffene Nachrichten verfügbar, und die Freigabe (Freigabe-E-Mail) ist für betroffene Nachrichten in der Quarantäne verfügbar.
  • $false: Die Freigabenachricht ist in den Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und die Freigabe- und Freigabe-E-Mail sind für betroffene Nachrichten in der Quarantäne nicht verfügbar.

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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:6
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToRequestRelease

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

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:

  • $true: "Freigabe anfordern" ist in Quarantänebenachrichtigungen für betroffene Nachrichten verfügbar, und "Freigabe anfordern" ist für betroffene Nachrichten in Quarantäne verfügbar.
  • $false: "Freigabe anfordern" ist in Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und "Freigabe anfordern" ist für betroffene Nachrichten in Quarantäne nicht verfügbar.

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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:7
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PermissionToViewHeader

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Parameter PermissionToViewHeader gibt an, ob Benutzer die Nachrichtenkopfzeilen von isolierten Nachrichten anzeigen dürfen. Gültige Werte sind:

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

Derzeit hat dieser Wert keine Auswirkungen auf verfügbare Aktionen in Quarantänebenachrichtigungen oder auf die Quarantäne für betroffene Nachrichten. Die Option "Nachrichtenkopf anzeigen" ist für betroffene Nachrichten in Quarantäne immer verfügbar.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:8
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-QuarantinePermissionsObject

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Parameter QuarantinePermissionsObject gibt die vorhandene Variable an, die die Quarantäneberechtigungen enthält, die Sie ändern möchten. Wenn Sie beispielsweise zuvor den Befehl $Perms = New-QuarantinePermissions <permissions>ausgeführt haben, verwenden Sie den Wert $Perms für diesen Parameter.

Parametereigenschaften

Typ:QuarantinePermissions
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:9
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.