Skip to content

Commit 04bb782

Browse files
chrisdachrisda
authored
Merge pull request MicrosoftDocs#10506 from MicrosoftDocs/chrisda
BlockedConnector cmdlets
2 parents 6bdf373 + 9db50c0 commit 04bb782

File tree

4 files changed

+161
-0
lines changed

4 files changed

+161
-0
lines changed

‎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/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/exchange.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow
206206

207207
### [Get-AttachmentFilterListConfig](Get-AttachmentFilterListConfig.md)
208208

209+
### [Get-BlockedConnector](Get-BlockedConnector.md)
210+
209211
### [Get-BlockedSenderAddress](Get-BlockedSenderAddress.md)
210212

211213
### [Get-ConfigAnalyzerPolicyRecommendation](Get-ConfigAnalyzerPolicyRecommendation.md)
@@ -324,6 +326,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow
324326

325327
### [Remove-AttachmentFilterEntry](Remove-AttachmentFilterEntry.md)
326328

329+
### [Remove-BlockedConnector](Remove-BlockedConnector.md)
330+
327331
### [Remove-BlockedSenderAddress](Remove-BlockedSenderAddress.md)
328332

329333
### [Remove-ContentFilterPhrase](Remove-ContentFilterPhrase.md)

‎exchange/mapping/serviceMapping.json

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@
9090
"Get-AgentLog": "antispam-antimalware",
9191
"Get-AttachmentFilterEntry": "antispam-antimalware",
9292
"Get-AttachmentFilterListConfig": "antispam-antimalware",
93+
"Get-BlockedConnector": "antispam-antimalware",
9394
"Get-BlockedSenderAddress": "antispam-antimalware",
9495
"Get-ConfigAnalyzerPolicyRecommendation": "antispam-antimalware",
9596
"Get-ContentFilterConfig": "antispam-antimalware",
@@ -150,6 +151,7 @@
150151
"Preview-QuarantineMessage": "antispam-antimalware",
151152
"Release-QuarantineMessage": "antispam-antimalware",
152153
"Remove-AttachmentFilterEntry": "antispam-antimalware",
154+
"Remove-BlockedConnector": "antispam-antimalware",
153155
"Remove-BlockedSenderAddress": "antispam-antimalware",
154156
"Remove-ContentFilterPhrase": "antispam-antimalware",
155157
"Remove-EOPProtectionPolicyRule": "antispam-antimalware",

0 commit comments

Comments
 (0)