Skip to content

Commit fe8f60c

Browse files
chrisdachrisda
committed
Merge branch 'main' into DMARCQ-chrisda
2 parents f0bca2d + 64be76e commit fe8f60c

26 files changed

+943
-96
lines changed

‎exchange/docs-conceptual/filter-properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1833,7 +1833,7 @@ For example, `Get-User -Filter "UpgradeStatus -ne 'None'"`.
18331833
|---|---|---|
18341834
|_msExchUsageLocation_|**Get-Mailbox** <br> **Get-MailUser** <br> **Get-Recipient**|String or `$null`|
18351835

1836-
This filter requires the ISO 3166-1 country name (for example, `United States`), or two-letter country code (for example `US`) for the user in Microsoft 365. For more information, see [Country Codes - ISO 3166](https://www.iso.org/iso-3166-country-codes.html). <br> For example, `Get-Recipient -Filter 'UsageLocation -ne $null'`.
1836+
This filter requires the ISO 3166-1 country name (for example, `United States`), or two-letter country code (for example `US`) for the user in Microsoft 365. For more information, see [Country Codes - ISO 3166](https://www.iso.org/iso-3166-country-codes.html). <br> For example, `Get-Recipient -Filter 'UsageLocation -eq "US"'`.
18371837

18381838
### UseDatabaseQuotaDefaults
18391839

‎exchange/exchange-ps/exchange/Add-RoleGroupMember.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,11 +93,9 @@ The Member parameter specifies who you want to add to the role group. You can sp
9393
9494
- Mailbox users
9595
- Mail users
96-
- Mail-enabled security groups (don't use in Security & Compliance PowerShell)
96+
- Mail-enabled security groups
9797
- Security groups (on-premises Exchange only)
9898
99-
You can't add security groups or mail-enabled security groups as members of the role group in the Microsoft Purview portal. You should add them via PowerShell with this parameter.
100-
10199
You can use any value that uniquely identifies the user or group. For example:
102100
103101
- Name

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

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
external help file: Microsoft.Exchange.TransportMailflow-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/get-blockedconnector
4+
applicable: Exchange Online, Exchange Online Protection
5+
title: Get-BlockedConnector
6+
schema: 2.0.0
7+
author: chrisda
8+
ms.author: chrisda
9+
ms.reviewer:
10+
---
11+
12+
# Get-BlockedConnector
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in the cloud-based service.
16+
17+
Use the Get-BlockedConnector cmdlet to view inbound connectors that have been detected as potentially compromised. Blocked connectors are prevented from sending email.
18+
19+
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
20+
21+
## SYNTAX
22+
23+
```
24+
Get-BlockedConnector [-ConnectorId <Guid>] [<CommonParameters>]
25+
```
26+
27+
## DESCRIPTION
28+
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://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
29+
30+
## EXAMPLES
31+
32+
### Example 1
33+
```powershell
34+
Get-BlockedConnector
35+
```
36+
37+
This example returns a summary list of all blocked connectors.
38+
39+
### Example 2
40+
```powershell
41+
Get-BlockedConnector -ConnectorId 159eb7c4-75d7-43e2-95fe-ced44b3e0a56 | Format-List
42+
```
43+
44+
This example returns detailed information for the specified blocked connector.
45+
46+
## PARAMETERS
47+
48+
### -ConnectorId
49+
The ConnectorId parameter specifies the blocked connector that you want to view. The value is a GUID (for example, 159eb7c4-75d7-43e2-95fe-ced44b3e0a56).
50+
51+
```yaml
52+
Type: Guid
53+
Parameter Sets: (All)
54+
Aliases:
55+
Applicable: Exchange Online, Exchange Online Protection
56+
57+
Required: False
58+
Position: Named
59+
Default value: None
60+
Accept pipeline input: False
61+
Accept wildcard characters: False
62+
```
63+
64+
### CommonParameters
65+
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://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).
66+
67+
## INPUTS
68+
69+
## OUTPUTS
70+
71+
## NOTES
72+
73+
## RELATED LINKS

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

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
---
2+
external help file: Microsoft.Exchange.TransportMailflow-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/get-reviewitems
4+
applicable: Exchange Online
5+
title: Get-ReviewItems
6+
schema: 2.0.0
7+
author: chrisda
8+
ms.author: chrisda
9+
ms.reviewer:
10+
---
11+
12+
# Get-ReviewItems
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in the cloud-based service.
16+
17+
Use the Get-ReviewItems to retrieve a list of disposition review items that are either pending review or already disposed for a specific retention label. It can also be used to retrieve a list of disposed items for a specific record label.
18+
19+
This cmdlet is available only in the Mailbox Import Export role, and by default, the role isn't assigned to any role groups. To use this cmdlet, you need to add the Mailbox Import Export role to a role group (for example, to the Organization Management role group). For more information, see [Add a role to a role group](https://learn.microsoft.com/Exchange/permissions/role-groups#add-a-role-to-a-role-group).
20+
21+
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
22+
23+
## SYNTAX
24+
25+
```
26+
Get-ReviewItems -TargetLabelId <String>
27+
[-Disposed <Boolean>]
28+
[-IncludeHeaders <Boolean>]
29+
[-PagingCookie <String>]
30+
[<CommonParameters>]
31+
```
32+
33+
## DESCRIPTION
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://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
35+
36+
The `Get-ReviewItems` cmdlet can be used to export a list of pending or disposed items from disposition review. To learn more about disposition review, see [Disposition of content](https://learn.microsoft.com/microsoft-365/compliance/disposition).
37+
38+
## EXAMPLES
39+
40+
### Example 1
41+
42+
```powershell
43+
$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true
44+
45+
$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers
46+
47+
$formattedExportItems
48+
```
49+
50+
This example retrieves the first page of items pending disposition for the label with the immutable ID value `a8cbeaac-e7aa-42ed-8dba-54200537c9c9`. The results are converted to PSObject types for each item and then output to the screen.
51+
52+
### Example 2
53+
54+
```powershell
55+
$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -Disposed $true
56+
57+
$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers
58+
59+
$formattedExportItems | Select Subject,Location,ReviewAction,Comment,DeletedBy,DeletedDate
60+
```
61+
62+
This example retrieves all disposed items for the label with an immutable ID of `a8cbeaac-e7aa-42ed-8dba-54200537c9c9` and selects specific columns to output to the screen.
63+
64+
### Example 3
65+
66+
```powershell
67+
$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true
68+
69+
$exportItems = $itemsPendingDisposition.ExportItems
70+
71+
While (![string]::IsNullOrEmpty($itemsPendingDisposition.PaginationCookie))
72+
{
73+
$itemsPendingDisposition = $itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -PagingCookie $itemsPendingDisposition.PaginationCookie
74+
$exportItems += $itemsPendingDisposition.ExportItems
75+
}
76+
77+
$exportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers | Export-Csv C:\temp\ItemsPendingDisposition.csv -NoTypeInformation
78+
```
79+
80+
This example retrieves all items pending disposition for the label with the immutable ID value `a8cbeaac-e7aa-42ed-8dba-54200537c9c9`. If multiple pages of items exist, the command continues until no more pages exist. The results are exported to the specified CSV file.
81+
82+
**Note**: While the cmdlet does not impose any limit to the number of items/pages that can be retrieved, other throttling may occur. To prevent throttling while retrieving a large number of items, we recommended including breaks in your script. You can use the PagingCookie parameter to pick up where the script left off after a break.
83+
84+
## PARAMETERS
85+
86+
### -TargetLabelId
87+
The TargetLabelId parameter specifies the label that you want to retrieve review items for. A valid value for this parameter is the immutable ID of the label.
88+
89+
To get the immutable ID value of a label, replace \<RetentionLabelName\> with the name of the label, and then run the following command in Exchange Online PowerShell: `Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId`.
90+
91+
```yaml
92+
Type: String
93+
Parameter Sets: (All)
94+
Aliases:
95+
Applicable: Exchange Online
96+
97+
Required: True
98+
Position: Named
99+
Default value: None
100+
Accept pipeline input: False
101+
Accept wildcard characters: False
102+
```
103+
104+
### -Disposed
105+
The Disposed parameter specifies whether to return disposed items instead of items pending disposition. Valid values are:
106+
107+
- $true: Return disposed items.
108+
- $false: Return items pending disposition. This is the default value.
109+
110+
```yaml
111+
Type: Boolean
112+
Parameter Sets: (All)
113+
Aliases:
114+
Applicable: Exchange Online
115+
116+
Required: False
117+
Position: Named
118+
Default value: None
119+
Accept pipeline input: False
120+
Accept wildcard characters: False
121+
```
122+
123+
### -IncludeHeaders
124+
The IncludeHeaders parameter specifies whether headers are returned as a property with the review items. Valid values are:
125+
126+
- $true: Headers are returned as a property with the review items. This option is useful when converting the output to a PSObject in PowerShell or when exporting to CSV.
127+
- $false: Headers are not returned as a property with the review items. This is the default value.
128+
129+
```yaml
130+
Type: Boolean
131+
Parameter Sets: (All)
132+
Aliases:
133+
Applicable: Exchange Online
134+
135+
Required: False
136+
Position: Named
137+
Default value: None
138+
Accept pipeline input: False
139+
Accept wildcard characters: False
140+
```
141+
142+
### -PagingCookie
143+
The PagingCookie parameter identifies the page to retrieve. This parameter is useful in the following scenarios:
144+
145+
- To avoid throttling while retrieving a large number of items.
146+
- As a method of starting where the last operation left off.
147+
148+
The PagingCookie value is returned in the PaginationCookie property each time the cmdlet is successfully run. If the PaginationCookie is blank (null), there are no more items to retrieve.
149+
150+
```yaml
151+
Type: String
152+
Parameter Sets: (All)
153+
Aliases:
154+
Applicable: Exchange Online
155+
156+
Required: False
157+
Position: Named
158+
Default value: None
159+
Accept pipeline input: False
160+
Accept wildcard characters: False
161+
```
162+
163+
### CommonParameters
164+
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).
165+
166+
## INPUTS
167+
168+
## OUTPUTS
169+
170+
## NOTES
171+
172+
## RELATED LINKS

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,10 @@ The Allow switch specifies that you're creating an allow entry. You don't need t
173173

174174
You can't use this switch with the Block switch.
175175

176+
**Note**: See [Allow entries in the Tenant Allow/Block List](https://learn.microsoft.com/microsoft-365/security/office-365-security/tenant-allow-block-list-about#allow-entries-in-the-tenant-allowblock-list), before you try to create an allow entry.
177+
178+
You can also use allow entries for third-party phishing simulation URLs with no expiration. For more information, see [Configure the delivery of third-party phishing simulations to users and unfiltered messages to SecOps mailboxes](https://learn.microsoft.com/microsoft-365/security/office-365-security/skip-filtering-phising-simulations-sec-ops-mailboxes).
179+
176180
```yaml
177181
Type: SwitchParameter
178182
Parameter Sets: (All)

‎exchange/exchange-ps/exchange/Release-QuarantineMessage.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -291,9 +291,9 @@ Accept wildcard characters: False
291291
```
292292

293293
### -ReportFalsePositive
294-
The ReportFalsePositive switch sends a notification message indicating the specified message was not spam. You don't need to specify a value with this switch.
294+
The ReportFalsePositive switch specifies whether to report the message as a false positive to Microsoft (good message marked as bad). You don't need to specify a value with this switch.
295295

296-
This switch is only available for quarantined spam messages.
296+
This switch is available only for quarantined spam messages.
297297

298298
```yaml
299299
Type: SwitchParameter

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

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
external help file: Microsoft.Exchange.TransportMailflow-Help.xml
3+
online version: https://learn.microsoft.com/powershell/module/exchange/remove-blockedconnector
4+
applicable: Exchange Online, Exchange Online Protection
5+
title: Remove-BlockedConnector
6+
schema: 2.0.0
7+
author: chrisda
8+
ms.author: chrisda
9+
ms.reviewer:
10+
---
11+
12+
# Remove-BlockedConnector
13+
14+
## SYNOPSIS
15+
This cmdlet is available only in the cloud-based service.
16+
17+
Use the Remove-BlockedConnector cmdlet to unblock inbound connectors that have been detected as potentially compromised. Blocked connectors are prevented from sending email.
18+
19+
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
20+
21+
## SYNTAX
22+
23+
```
24+
Remove-BlockedConnector -ConnectorId <Guid> [-Reason <String>] [<CommonParameters>]
25+
```
26+
27+
## DESCRIPTION
28+
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://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
29+
30+
## EXAMPLES
31+
32+
### Example 1
33+
```powershell
34+
Remove-BlockedConnector -ConnectorId 159eb7c4-75d7-43e2-95fe-ced44b3e0a56
35+
```
36+
37+
This unblocks the specified blocked connector.
38+
39+
## PARAMETERS
40+
41+
### -ConnectorId
42+
The ConnectorId parameter specifies the blocked connector that you want to unblock. The value is a GUID (for example, 159eb7c4-75d7-43e2-95fe-ced44b3e0a56). You can find this value from the output of the Get-BlockedConnector command.
43+
44+
```yaml
45+
Type: Guid
46+
Parameter Sets: (All)
47+
Aliases:
48+
Applicable: Exchange Online, Exchange Online Protection
49+
50+
Required: True
51+
Position: Named
52+
Default value: None
53+
Accept pipeline input: False
54+
Accept wildcard characters: False
55+
```
56+
57+
### -Reason
58+
The Reason parameter specifies comments about why you're unblocking the blocked connector. If the value contains spaces, enclose the value in quotation marks (").
59+
60+
```yaml
61+
Type: String
62+
Parameter Sets: (All)
63+
Aliases:
64+
Applicable: Exchange Online, Exchange Online Protection
65+
66+
Required: False
67+
Position: Named
68+
Default value: None
69+
Accept pipeline input: False
70+
Accept wildcard characters: False
71+
```
72+
73+
### CommonParameters
74+
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://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).
75+
76+
## INPUTS
77+
78+
## OUTPUTS
79+
80+
## NOTES
81+
82+
## RELATED LINKS

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ The Member parameter specifies who to remove from the role group. You can specif
9393
9494
- Mailbox users
9595
- Mail users
96-
- Mail-enabled security groups (don't use in Security & Compliance PowerShell)
96+
- Mail-enabled security groups
9797
- Security groups (on-premises Exchange only)
9898
9999
You can use any value that uniquely identifies the user or group. For example:

0 commit comments

Comments
 (0)