New-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 New-QuarantinePermissions, um eine Variable zu erstellen, die ein Quarantäneberechtigungsobjekt enthält, das mit dem EndUserQuarantinePermission-Parameter für die New-QuarantinePolicy- oder Set-QuarantinePolicy-Cmdlets in derselben PowerShell-Sitzung verwendet werden soll.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
New-QuarantinePermissions
[[-PermissionToAllowSender] <Boolean>]
[[-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. 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
$NoAccess = New-QuarantinePermissions
In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe "Keine Zugriffsberechtigungen" in Quarantänerichtlinien verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $NoAccessgespeichert.
In derselben PowerShell-Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantinePolicy- oder Set-QuarantinePolicy-Befehl verwenden$NoAccess.
Beispiel 2
$LimitedAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true
In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe Eingeschränkte Zugriffsberechtigungen in Quarantänerichtlinien verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $LimitedAccessgespeichert.
In derselben PowerShell-Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantinePolicy- oder Set-QuarantinePolicy-Befehl verwenden$LimitedAccess.
Beispiel 3
$FullAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true
In diesem Beispiel werden dieselben Berechtigungen erstellt, die von der Gruppe Vollzugriffsberechtigungen in Quarantänerichtlinien verwendet werden. Das Berechtigungsobjekt wird in der Variablen mit dem Namen $FullAccessgespeichert.
In derselben PowerShell-Sitzung können Sie für den EndUserQuarantinePermissions-Parameterwert in einem New-QuarantinePolicy- oder Set-QuarantinePolicy-Befehl verwenden$FullAccess.
Parameter
-PermissionToAllowSender
Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer
Der Parameter PermissionToAllowSender 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, integriertes Sicherheits-Add-On für lokale Postfächer
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, 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 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, 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 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, integriertes Sicherheits-Add-On für lokale Postfächer
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, integriertes Sicherheits-Add-On für lokale Postfächer
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, 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 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, integriertes Sicherheits-Add-On für lokale Postfächer
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 die verfügbaren 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 |
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.