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.