Skip to content

Commit 13b9bc7

Browse files
chrisdachrisda
authored
Merge pull request #8513 from MicrosoftDocs/TABL-chrisda
TABL-chrisda to Master
2 parents aa6c6c4 + 7e26ce6 commit 13b9bc7

File tree

4 files changed

+314
-67
lines changed

4 files changed

+314
-67
lines changed

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

Lines changed: 51 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,25 @@ 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+
- Tenant: This is the default value.
190+
191+
```yaml
192+
Type: ListSubType[]
193+
Parameter Sets: (All)
194+
Aliases:
195+
Applicable: Exchange Online, Exchange Online Protection
196+
197+
Required: False
198+
Position: Named
199+
Default value: None
200+
Accept pipeline input: False
201+
Accept wildcard characters: False
202+
```
203+
158204
### -OutputJson
159205
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.
160206

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

Lines changed: 89 additions & 26 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 *.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 with no expiration. 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:
@@ -91,7 +85,9 @@ The Entries parameter specifies the URL or files that you want to add to the Ten
9185

9286
To enter multiple values, use the following syntax: `"Value1","Value2",..."ValueN"`.
9387

94-
You can't mix URL and file values or allow and block actions in the same command. You can't modify existing URL or file values after you create the entry (there's no Entries parameter on the Set-TenantAllowBlockListItems cmdlet).
88+
You can't mix URL and file values or allow and block actions in the same command.
89+
90+
You can't modify the URL or file values after you create the entry.
9591

9692
```yaml
9793
Type: String[]
@@ -166,6 +162,57 @@ Accept pipeline input: False
166162
Accept wildcard characters: False
167163
```
168164

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

@@ -200,6 +247,22 @@ Accept pipeline input: False
200247
Accept wildcard characters: False
201248
```
202249

250+
### -SubmissionID
251+
This parameter is reserved for internal Microsoft use.
252+
253+
```yaml
254+
Type: String
255+
Parameter Sets: (All)
256+
Aliases:
257+
Applicable: Exchange Online, Exchange Online Protection
258+
259+
Required: False
260+
Position: Named
261+
Default value: None
262+
Accept pipeline input: False
263+
Accept wildcard characters: False
264+
```
265+
203266
### CommonParameters
204267
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).
205268

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

Lines changed: 67 additions & 4 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 *.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 entries that you want to remove based on the ListType parameter value. Valid values are:
67+
68+
- Url: The exact URL entry value.
69+
- File: The exact SHA256 file hash value.
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
49-
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).
91+
The Ids parameter specifies the entries that you want to modify. To find this value, use the Get-TenantAllowBlockListItems cmdlet and the Identity property value (a URL or a file hash).
5092
5193
An example value for this parameter is `RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0`.
5294

53-
You can specify multiple values separated by commas.
95+
To enter multiple values, use the following syntax: `"Value1","Value2",..."ValueN"`.
96+
97+
You can't use this parameter with the Entries parameter.
5498

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,25 @@ 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+
- Tenant: This is the default value.
136+
137+
```yaml
138+
Type: ListSubType
139+
Parameter Sets: (All)
140+
Aliases:
141+
Applicable: Exchange Online, Exchange Online Protection
142+
143+
Required: False
144+
Position: Named
145+
Default value: None
146+
Accept pipeline input: False
147+
Accept wildcard characters: False
148+
```
149+
87150
### -OutputJson
88151
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.
89152

0 commit comments

Comments
 (0)