You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This cmdlet is available only in the cloud-based service.
16
16
17
-
Use the Get-QuarantineTag cmdlet to view quarantine tags in your cloud-based organization.
17
+
Use the Get-QuarantinePolicy cmdlet to view quarantine policies in your cloud-based organization.
18
18
19
19
**Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
20
20
@@ -23,43 +23,43 @@ For information about the parameter sets in the Syntax section below, see [Excha
Quarantine tags allow you to configure the allowed end-user actions on quarantined messages in supported features that quarantine messages.
32
+
Quarantine policies define what users are allowed to do to quarantined messages based on why the message was quarantined (for supported features). For more information, see [Quarantine policies](https://docs.microsoft.com/microsoft-365/security/office-365-security/quarantine-policies).
33
33
34
34
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
35
35
36
36
## EXAMPLES
37
37
38
38
### Example 1
39
39
```powershell
40
-
Get-QuarantineTag | Format-Table Name
40
+
Get-QuarantinePolicy | Format-Table Name
41
41
```
42
42
43
-
This example returns as summary list of all quarantine tags.
43
+
This example returns as summary list of all quarantine policies.
44
44
45
45
### Example 2
46
46
```powershell
47
-
Get-QuarantineTag -Identity NoAccess
47
+
Get-QuarantinePolicy -Identity NoAccess
48
48
```
49
49
50
-
This example returns detailed information about the quarantine tag named NoAccess.
50
+
This example returns detailed information about the quarantine policy named NoAccess.
This example returns detailed information about the default quarantine tag named GlobalDefaultTag that controls the global end-user spam notification settings.
57
+
This example returns detailed information about the default quarantine policy named GlobalDefaultTag that controls the global quarantine notification (formerly known as end-user spam notification) settings.
58
58
59
59
## PARAMETERS
60
60
61
61
### -Identity
62
-
The Identity parameter specifies the quarantine tag you want to view. You can use any value that uniquely identifies the quarantine tag. For example:
62
+
The Identity parameter specifies the quarantine policy you want to view. You can use any value that uniquely identifies the quarantine policy. For example:
The QuarantineTagType parameter filters the results by the specified quarantine tag type. Valid values are:
81
+
### -QuarantinePolicyType
82
+
The QuarantinePolicyType parameter filters the results by the specified quarantine policy type. Valid values are:
83
83
84
-
- PolicyQuarantineTag: This is the default value, and returns built-in and custom quarantine tags.
85
-
- GlobalQuarantineTag: This value is required to return the global settings (end-user quarantine notification settings) in the quarantine tag named GlobalDefaultTag.
84
+
- QuarantinePolicy: This is the default value, and returns built-in and custom quarantine policies.
85
+
- GlobalQuarantinePolicy: This value is required to return the global settings (quarantine notification settings) in the quarantine policy named GlobalDefaultTag.
This cmdlet is available only in the cloud-based service.
16
16
17
-
Use the New-QuarantineTag cmdlet to create quarantine tags in your cloud-based organization.
17
+
Use the New-QuarantinePolicy cmdlet to create quarantine policies in your cloud-based organization.
18
18
19
19
**Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
20
20
@@ -23,7 +23,7 @@ For information about the parameter sets in the Syntax section below, see [Excha
Quarantine tags allow you to configure the allowed end-user actions on quarantined messages in supported features that quarantine messages.
49
+
Quarantine policies define what users are allowed to do to quarantined messages based on why the message was quarantined (for supported features). For more information, see [Quarantine policies](https://docs.microsoft.com/microsoft-365/security/office-365-security/quarantine-policies).
50
50
51
51
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
This example creates a new quarantine tag named LimitedAccess with the same permissions as Limited access preset permissions group.
71
+
This example creates a new quarantine policy named LimitedAccess with the same permissions as Limited access preset permissions group.
72
72
73
73
The first command uses the New-QuarantinePermissions cmdlet to store the permissions object in a variable. The second command uses the variable for the value of the EndUserQuarantinePermissions parameter.
74
74
75
75
## PARAMETERS
76
76
77
77
### -Name
78
-
The Name parameter specifies a unique name for the quarantine tag. If the value contains spaces, enclose the value in quotation marks (").
78
+
The Name parameter specifies a unique name for the quarantine policy. If the value contains spaces, enclose the value in quotation marks (").
The AdminDisplayName parameter specifies a description for the quarantine tag. If the value contains spaces, enclose the value in quotation marks (").
94
+
The AdminDisplayName parameter specifies a description for the quarantine policy. If the value contains spaces, enclose the value in quotation marks (").
95
95
96
96
```yaml
97
97
Type: String
@@ -203,24 +203,8 @@ Accept pipeline input: False
203
203
Accept wildcard characters: False
204
204
```
205
205
206
-
### -ESNEnabled
207
-
This parameter is reserved for internal Microsoft use.
The EndUserQuarantinePermissionsValue parameter specifies the end-user permissions for the quarantine tag.
207
+
The EndUserQuarantinePermissionsValue parameter specifies the end-user permissions for the quarantine policy.
224
208
225
209
A value for this parameter requires the New-QuarantinePermissions cmdlet. Store the results of the New-QuarantinePermissions command in a variable (for example, `$Perms = New-QuarantinePermissions <permissions>`) and then use the variable name (`$Perms`) for this parameter. For more information, see [New-QuarantinePermissions](https://docs.microsoft.com/powershell/module/exchange/new-quarantinepermissions).
The EndUserQuarantinePermissionsValue parameter specifies the end-user permissions for the quarantine tag.
227
+
The EndUserQuarantinePermissionsValue parameter specifies the end-user permissions for the quarantine policy.
244
228
245
229
This parameter uses a decimal value that's converted from a binary value. The binary value corresponds to the list of available permissions in a specific order. For each permission, the value 1 equals True and the value 0 equals False. The required order is described in the following list:
246
230
@@ -309,6 +293,25 @@ Accept pipeline input: False
309
293
Accept wildcard characters: False
310
294
```
311
295
296
+
### -ESNEnabled
297
+
The ESNEnabled parameter specifies whether to enable quarantine notifications (formerly known as end-user spam notifications) for the policy. Valid values are:
298
+
299
+
- $true: Quarantine notifications are enabled.
300
+
- $false: Quarantine notifications are disabled. User can only access quarantined messages in quarantine, not in email notifications. This is the default value.S
This cmdlet is available only in the cloud-based service.
16
16
17
-
Use the Remove-QuarantineTag cmdlet to remove custom quarantine tags from your cloud-based organization.
17
+
Use the Remove-QuarantinePolicy cmdlet to remove custom quarantine policies from your cloud-based organization.
18
18
19
19
**Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
20
20
@@ -23,29 +23,29 @@ For information about the parameter sets in the Syntax section below, see [Excha
You can't remove built-in quarantine tags that start with "Default" in the name.
32
+
You can't remove the built-in quarantine policies named AdminOnlyAccessPolicy or DefaultFullAccessPolicy.
33
33
34
34
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
This example removes the quarantine tag named Contoso Engineering.
43
+
This example removes the quarantine policy named Contoso Engineering.
44
44
45
45
## PARAMETERS
46
46
47
47
### -Identity
48
-
The Identity parameter specifies the quarantine tag you want to remove. You can use any value that uniquely identifies the quarantine tag. For example:
48
+
The Identity parameter specifies the quarantine policy you want to remove. You can use any value that uniquely identifies the quarantine policy. For example:
0 commit comments