Set-QuarantinePermissions
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Hinweis: Anstatt dieses Cmdlet zum Festlegen von Quarantänerichtlinienberechtigungen zu verwenden, empfiehlt es sich, 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 vom New-QuarantinePermissions erstellt und in der aktuellen PowerShell-Sitzung als Variable gespeichert wurden. Sie verwenden die Variable als Wert für den Parameter EndUserQuarantinePermission für die Cmdlets New-QuarantinePolicy oder Set-QuarantinePolicy in derselben PowerShell-Sitzung.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standardwert)
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 aus $Perms , 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 Quarantänerichtlinienberechtigungen in der beendenden $Perms Variablen geändert, die zuvor mit dem Cmdlet 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 EndUserQuarantinePermissions-Parameterwert in einem New-QuarantinePolicy- oder Set-QuarantinePolicy-Befehl verwenden$Perms.
Parameter
-PermissionToAllowSender
Anwendbar: Exchange Online, Exchange Online Protection
Der Parameter PermissionToBlockSender gibt an, ob Benutzer den in Quarantäne befindlichen Nachrichtensender 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 die Standardeinstellung.
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, Exchange Online Protection
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: Absender blockieren ist in 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 Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und Absender blockieren ist für betroffene Nachrichten in Quarantäne nicht verfügbar. Dieser Wert ist die Standardeinstellung.
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, Exchange Online Protection
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 Quarantäne verfügbar.
- $false: Nachrichten löschen und aus Quarantäne löschen sind für betroffene Nachrichten in Quarantäne nicht verfügbar. Dieser Wert ist die Standardeinstellung.
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, Exchange Online Protection
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 die Standardeinstellung.
Derzeit hat dieser Wert keine Auswirkungen auf die verfügbaren Aktionen in Quarantänebenachrichtigungen oder Quarantäne für betroffene Nachrichten. Endbenutzer können unter Quarantäne gestellte Nachrichten nicht 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, Exchange Online Protection
Der Parameter PermissionToPreview gibt an, ob Benutzer eine Vorschau der in Quarantäne befindlichen Nachrichten anzeigen dürfen. Gültige Werte sind:
- $true: Die Vorschaunachricht ist für betroffene Nachrichten in Quarantäne verfügbar.
- $false: Die Vorschaunachricht ist für betroffene Nachrichten in Quarantäne nicht verfügbar. Dieser Wert ist die Standardeinstellung.
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, Exchange Online Protection
Der Parameter PermissionToRelease gibt an, ob Benutzer betroffene Nachrichten direkt aus der Quarantäne freigeben dürfen. Gültige Werte sind:
- $true: Release ist in Quarantänebenachrichtigungen für betroffene Nachrichten verfügbar, und Release (Release-E-Mail) ist für betroffene Nachrichten in Quarantäne verfügbar.
- $false: Releasenachricht ist in Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und Release- und Release-E-Mail sind für betroffene Nachrichten in 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, Exchange Online Protection
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: Release anfordern ist in Quarantänebenachrichtigungen für betroffene Nachrichten verfügbar, und Release anfordern ist für betroffene Nachrichten in Quarantäne verfügbar.
- $false: Release anfordern ist in Quarantänebenachrichtigungen für betroffene Nachrichten nicht verfügbar, und Release 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, Exchange Online Protection
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. Dieser Wert ist die Standardeinstellung.
Derzeit hat dieser Wert keine Auswirkungen auf verfügbare Aktionen in Quarantänebenachrichtigungen oder Quarantäne für betroffene Nachrichten. Der Nachrichtenheader 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, Exchange Online Protection
Der Parameter QuarantinePermissionsObject gibt die vorhandene Variable an, 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.