Skip to content

Commit 7403c64

Browse files
chrisdachrisda
committed
Updates to TABL cmdlets for advanced delivery
1 parent 520b1f6 commit 7403c64

File tree

4 files changed

+310
-62
lines changed

4 files changed

+310
-62
lines changed

‎exchange/exchange-ps/exchange/Get-TenantAllowBlockListItems.md

Lines changed: 52 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,20 +25,24 @@ For information about the parameter sets in the Syntax section below, see [Excha
2525

2626
## SYNTAX
2727

28-
### NoExpiration
28+
### Expiration (Default)
2929
```
30-
Get-TenantAllowBlockListItems -ListType <ListType> [-NoExpiration]
30+
Get-TenantAllowBlockListItems -ListType <ListType> [-ExpirationDate <DateTime>]
31+
[-Allow]
3132
[-Block]
3233
[-Entry <String>]
34+
[-ListSubType <ListSubType[]>]
3335
[-OutputJson]
3436
[<CommonParameters>]
3537
```
3638

37-
### Expiration
39+
### NoExpiration
3840
```
39-
Get-TenantAllowBlockListItems -ListType <ListType> [-ExpirationDate <DateTime>]
41+
Get-TenantAllowBlockListItems -ListType <ListType> [-NoExpiration]
42+
[-Allow]
4043
[-Block]
4144
[-Entry <String>]
45+
[-ListSubType <ListSubType[]>]
4246
[-OutputJson]
4347
[<CommonParameters>]
4448
```
@@ -50,7 +54,7 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
5054

5155
### Example 1
5256
```powershell
53-
Get-TenantAllowBlockListItems -ListType Url -Action Block
57+
Get-TenantAllowBlockListItems -ListType Url -Block
5458
```
5559

5660
This example returns all blocked URLs.
@@ -62,6 +66,13 @@ Get-TenantAllowBlockListItems -ListType FileHash -Entry "9f86d081884c7d659a2feaa
6266

6367
This example returns information for the specified file hash value.
6468

69+
### Example 3
70+
```powershell
71+
Get-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery
72+
```
73+
74+
This example returns information for all allowed third-party phishing simulation URLs. For more information, see [Configure the delivery of third-party phishing simulations to users and unfiltered messages to SecOps mailboxes](https://docs.microsoft.com/microsoft-365/security/office-365-security/configure-advanced-delivery).
75+
6576
## PARAMETERS
6677

6778
### -ListType
@@ -118,6 +129,22 @@ Accept pipeline input: False
118129
Accept wildcard characters: False
119130
```
120131
132+
### -Allow
133+
The Allow switch filters the results for allow entries. You don't need to specify a value with this switch.
134+
135+
```yaml
136+
Type: SwitchParameter
137+
Parameter Sets: (All)
138+
Aliases:
139+
Applicable: Exchange Online, Exchange Online Protection
140+
141+
Required: False
142+
Position: Named
143+
Default value: None
144+
Accept pipeline input: False
145+
Accept wildcard characters: False
146+
```
147+
121148
### -Block
122149
The Block switch filters the results for block entries. You don't need to specify a value with this switch.
123150
@@ -155,6 +182,26 @@ Accept pipeline input: False
155182
Accept wildcard characters: False
156183
```
157184

185+
### -ListSubType
186+
The ListSubType parameter filters the results by subtype. Valid values are:
187+
188+
- AdvancedDelivery
189+
- Submission
190+
- Tenant
191+
192+
```yaml
193+
Type: ListSubType[]
194+
Parameter Sets: (All)
195+
Aliases:
196+
Applicable: Exchange Online, Exchange Online Protection
197+
198+
Required: False
199+
Position: Named
200+
Default value: None
201+
Accept pipeline input: False
202+
Accept wildcard characters: False
203+
```
204+
158205
### -OutputJson
159206
The OutputJson switch specifies whether to return all entries in a single JSON value. You don't need to specify a value with this switch.
160207

‎exchange/exchange-ps/exchange/New-TenantAllowBlockListItems.md

Lines changed: 87 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -27,19 +27,25 @@ For information about the parameter sets in the Syntax section below, see [Excha
2727

2828
### Expiration
2929
```
30-
New-TenantAllowBlockListItems -Action <ItemAction> -Entries <String[]> -ListType <ListType>
31-
[-ExpirationDate <DateTime>]
30+
New-TenantAllowBlockListItems -Entries <String[]> -ListType <ListType> [-ExpirationDate <DateTime>]
31+
[-Allow]
32+
[-Block]
33+
[-ListSubType <ListSubType>]
3234
[-Notes <String>]
3335
[-OutputJson]
36+
[-SubmissionID <String>]
3437
[<CommonParameters>]
3538
```
3639

3740
### NoExpiration
3841
```
39-
New-TenantAllowBlockListItems -Action <ItemAction> -Entries <String[]> -ListType <ListType>
40-
[-NoExpiration]
42+
New-TenantAllowBlockListItems -Entries <String[]> -ListType <ListType> [-NoExpiration]
43+
[-Allow]
44+
[-Block]
45+
[-ListSubType <ListSubType>]
4146
[-Notes <String>]
4247
[-OutputJson]
48+
[-SubmissionID <String>]
4349
[<CommonParameters>]
4450
```
4551

@@ -50,38 +56,26 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
5056

5157
### Example 1
5258
```powershell
53-
New-TenantAllowBlockListItems -ListType Url -Action Block -Entries ~contoso.com~
59+
New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~
5460
```
5561

5662
This example adds a URL block entry for contoso.com and all subdomains (for example, contoso.com, www.contoso.com, xyz.abc.contoso.com, and www.contoso.com/b). Because we didn't use the ExpirationDate or NoExpiration parameters, the entry expires after 30 days.
5763

5864
### Example 2
5965
```powershell
60-
New-TenantAllowBlockListItems -ListType FileHash -Action Allow -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration
66+
New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration
6167
```
6268

63-
This example adds a file allow entry for the specified files that never expires.
69+
This example adds a file block entry for the specified files that never expires.
6470

65-
## PARAMETERS
66-
67-
### -Action
68-
The Action parameter specifies the action type for the entry. Valid values are:
69-
70-
- Allow
71-
- Block
71+
### Example 3
72+
```powershell
73+
New-TenantAllowBlockListItems -ListType Url -Allow -ListSubType AdvancedDelivery -Entries phishing.fabrikam.com -NoExpiration
74+
```
7275

73-
```yaml
74-
Type: ItemAction
75-
Parameter Sets: (All)
76-
Aliases:
77-
Applicable: Exchange Online, Exchange Online Protection
76+
This example adds a URL allow entry for the specified third-party phishing simulation URL. For more information, see [Configure the delivery of third-party phishing simulations to users and unfiltered messages to SecOps mailboxes](https://docs.microsoft.com/microsoft-365/security/office-365-security/configure-advanced-delivery).
7877

79-
Required: True
80-
Position: Named
81-
Default value: None
82-
Accept pipeline input: False
83-
Accept wildcard characters: False
84-
```
78+
## PARAMETERS
8579

8680
### -Entries
8781
The Entries parameter specifies the URL or files that you want to add to the Tenant Allow/Block List based on the value of the ListType parameter:
@@ -166,6 +160,58 @@ Accept pipeline input: False
166160
Accept wildcard characters: False
167161
```
168162

163+
### -Allow
164+
The Allow switch specifies that this is an allow entry for advanced delivery (third-party phishing simulation URLs). You don't need to specify a value with this switch.
165+
166+
```yaml
167+
Type: SwitchParameter
168+
Parameter Sets: (All)
169+
Aliases:
170+
Applicable: Exchange Online, Exchange Online Protection
171+
172+
Required: False
173+
Position: Named
174+
Default value: None
175+
Accept pipeline input: False
176+
Accept wildcard characters: False
177+
```
178+
179+
### -Block
180+
The Block switch specifies that this is a block entry. You don't need to specify a value with this switch.
181+
182+
```yaml
183+
Type: SwitchParameter
184+
Parameter Sets: (All)
185+
Aliases:
186+
Applicable: Exchange Online, Exchange Online Protection
187+
188+
Required: False
189+
Position: Named
190+
Default value: None
191+
Accept pipeline input: False
192+
Accept wildcard characters: False
193+
```
194+
195+
### -ListSubType
196+
The ListSubType parameter specifies the subtype for this entry. Valid values are:
197+
198+
- AdvancedDelivery
199+
- Submission
200+
- Tenant
201+
202+
```yaml
203+
Type: ListSubType
204+
Parameter Sets: (All)
205+
Aliases:
206+
Applicable: Exchange Online, Exchange Online Protection
207+
208+
Required: False
209+
Position: Named
210+
Default value: None
211+
Accept pipeline input: False
212+
Accept wildcard characters: False
213+
```
214+
169215
### -Notes
170216
The Notes parameters specifies additional information about the object. If the value contains spaces, enclose the value in quotation marks (").
171217

@@ -200,6 +246,22 @@ Accept pipeline input: False
200246
Accept wildcard characters: False
201247
```
202248

249+
### -SubmissionID
250+
{{ Fill SubmissionID Description }}
251+
252+
```yaml
253+
Type: String
254+
Parameter Sets: (All)
255+
Aliases:
256+
Applicable: Exchange Online, Exchange Online Protection
257+
258+
Required: False
259+
Position: Named
260+
Default value: None
261+
Accept pipeline input: False
262+
Accept wildcard characters: False
263+
```
264+
203265
### CommonParameters
204266
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).
205267

‎exchange/exchange-ps/exchange/Remove-TenantAllowBlockListItems.md

Lines changed: 66 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,18 @@ For information about the parameter sets in the Syntax section below, see [Excha
2525

2626
## SYNTAX
2727

28+
### Entries
29+
```
30+
Remove-TenantAllowBlockListItems -Entries <String[]> -ListType <ListType>
31+
[-ListSubType <ListSubType>]
32+
[-OutputJson]
33+
[<CommonParameters>]
34+
```
35+
36+
### Ids
2837
```
2938
Remove-TenantAllowBlockListItems -Ids <String[]> -ListType <ListType>
39+
[-ListSubType <ListSubType>]
3040
[-OutputJson]
3141
[<CommonParameters>]
3242
```
@@ -41,20 +51,54 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
4151
Remove-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0l"
4252
```
4353

44-
This example removes the specified URL entry from the Allow/Block List.
54+
This example removes the specified URL entry from the Tenant Allow/Block List.
55+
56+
### Example 2
57+
```powershell
58+
Remove-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries phishing.fabrikam.com
59+
```
60+
61+
This example removes the URL allow entry for the specified third-party phishing simulation URL. For more information, see [Configure the delivery of third-party phishing simulations to users and unfiltered messages to SecOps mailboxes](https://docs.microsoft.com/microsoft-365/security/office-365-security/configure-advanced-delivery).
4562

4663
## PARAMETERS
4764

65+
### -Entries
66+
The Entries parameter specifies the URL or files that you want to remove from the Tenant Allow/Block List based on the value of the ListType parameter:
67+
68+
- URLs: Use IPv4 or IPv6 addresses or hostnames. Wildcards (* and ~) are supported in hostnames. Protocols, TCP/UDP ports, or user credentials are not supported. For details, see [URL syntax for the Tenant Allow/Block List](https://docs.microsoft.com/microsoft-365/security/office-365-security/tenant-allow-block-list#url-syntax-for-the-tenant-allowedblocked-list).
69+
- Files: Use the SHA256 hash value of the file. In Windows, you can find the SHA256 hash value by running the following command in a Command Prompt: `certutil.exe -hashfile "<Path>\<Filename>" SHA256`. An example value is `768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3`.
70+
71+
To enter multiple values, use the following syntax: `"Value1","Value2",..."ValueN"`.
72+
73+
You can't mix URL and file values or allow and block actions in the same command.
74+
75+
You can't use this parameter with the Ids parameter.
76+
77+
```yaml
78+
Type: String[]
79+
Parameter Sets: Entries
80+
Aliases:
81+
Applicable: Exchange Online, Exchange Online Protection
82+
83+
Required: True
84+
Position: Named
85+
Default value: None
86+
Accept pipeline input: False
87+
Accept wildcard characters: False
88+
```
89+
4890
### -Ids
4991
The Ids parameter specifies the entry that you want to modify. To find this value, use the Get-TenantAllowBlockListItems cmdlet and the Entry property value (a URL or a file hash).
5092
5193
An example value for this parameter is `RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0`.
5294

5395
You can specify multiple values separated by commas.
5496

97+
You can't use this parameter with the Entries parameter.
98+
5599
```yaml
56100
Type: String[]
57-
Parameter Sets: (All)
101+
Parameter Sets: Ids
58102
Aliases:
59103
Applicable: Exchange Online, Exchange Online Protection
60104
@@ -84,6 +128,26 @@ Accept pipeline input: False
84128
Accept wildcard characters: False
85129
```
86130

131+
### -ListSubType
132+
The ListSubType specifies the subtype of this entry. Valid values are:
133+
134+
- AdvancedDelivery
135+
- Submission
136+
- Tenant
137+
138+
```yaml
139+
Type: ListSubType
140+
Parameter Sets: (All)
141+
Aliases:
142+
Applicable: Exchange Online, Exchange Online Protection
143+
144+
Required: False
145+
Position: Named
146+
Default value: None
147+
Accept pipeline input: False
148+
Accept wildcard characters: False
149+
```
150+
87151
### -OutputJson
88152
The OutputJson switch specifies whether to return all entries in a single JSON value. You don't need to specify a value with this switch.
89153

0 commit comments

Comments
 (0)