Skip to content

Commit 93a851c

Browse files
authored
Merge pull request MicrosoftDocs#4966 from MicrosoftDocs/chrisda
Enhanced Filtering Updates to New/Set-InboundConnector
2 parents 9f0f32a + effa5ec commit 93a851c

File tree

4 files changed

+286
-23
lines changed

4 files changed

+286
-23
lines changed

exchange/exchange-ps/exchange/mail-flow/New-InboundConnector.md

Lines changed: 129 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,12 +23,25 @@ For information about the parameter sets in the Syntax section below, see [Excha
2323

2424
```
2525
New-InboundConnector [-Name] <String> -SenderDomains <MultiValuedProperty>
26-
[-AssociatedAcceptedDomains <MultiValuedProperty>] [-CloudServicesMailEnabled <Boolean>]
27-
[-Comment <String>] [-Confirm] [-ConnectorSource <TenantConnectorSource>]
28-
[-ConnectorType <TenantConnectorType>] [-Enabled <Boolean>] [-RequireTls <Boolean>]
29-
[-RestrictDomainsToCertificate <Boolean>] [-RestrictDomainsToIPAddresses <Boolean>]
30-
[-SenderIPAddresses <MultiValuedProperty>] [-TlsSenderCertificateName <TlsCertificate>]
31-
[-TreatMessagesAsInternal <Boolean>] [-WhatIf] [<CommonParameters>]
26+
[-AssociatedAcceptedDomains <MultiValuedProperty>]
27+
[-CloudServicesMailEnabled <Boolean>]
28+
[-Comment <String>]
29+
[-Confirm]
30+
[-ConnectorSource <TenantConnectorSource>]
31+
[-ConnectorType <TenantConnectorType>]
32+
[-EFSkipIPs <MultiValuedProperty>]
33+
[-EFSkipLastIP <Boolean>]
34+
[-EFSkipMailGateway <MultiValuedProperty>]
35+
[-EFTestMode <Boolean>]
36+
[-Enabled <Boolean>]
37+
[-RequireTls <Boolean>]
38+
[-RestrictDomainsToCertificate <Boolean>]
39+
[-RestrictDomainsToIPAddresses <Boolean>]
40+
[-ScanAndDropRecipients <MultiValuedProperty>]
41+
[-SenderIPAddresses <MultiValuedProperty>]
42+
[-TlsSenderCertificateName <TlsCertificate>]
43+
[-TreatMessagesAsInternal <Boolean>]
44+
[-WhatIf] [<CommonParameters>]
3245
```
3346

3447
## DESCRIPTION
@@ -210,6 +223,100 @@ Accept pipeline input: False
210223
Accept wildcard characters: False
211224
```
212225
226+
### -EFSkipIPs
227+
the EFSkipIPs parameter specifies the source IP addresses to skip in Enhanced Filtering for Connectors when the EFSkipLastIP parameter value is $false. Valid values are:
228+
229+
- A single IP address: For example, 192.168.1.1.
230+
231+
- An IP address range: For example, 192.168.0.1-192.168.0.254.
232+
233+
- Classless Inter-Domain Routing (CIDR) IP: For example, 192.168.3.1/24
234+
235+
You can specify multiple IP addresses or address range entries separated by commas.
236+
237+
```yaml
238+
Type: MultiValuedProperty
239+
Parameter Sets: (All)
240+
Aliases:
241+
Applicable: Exchange Online, Exchange Online Protection
242+
243+
Required: False
244+
Position: Named
245+
Default value: None
246+
Accept pipeline input: False
247+
Accept wildcard characters: False
248+
```
249+
250+
### -EFSkipLastIP
251+
The EFSkipIPs parameter specifies the behavior of Enhanced Filtering for Connectors. Valid values are:
252+
253+
- $true: Only the last message source is skipped.
254+
255+
- $false: Skip the source IP addresses specified by the EFSkipIPs parameter. If no IP addresses are specified, Enhanced Filtering for Connectors is disabled on the connector. This is the default value.
256+
257+
```yaml
258+
Type: Boolean
259+
Parameter Sets: (All)
260+
Aliases:
261+
Applicable: Exchange Online, Exchange Online Protection
262+
263+
Required: False
264+
Position: Named
265+
Default value: None
266+
Accept pipeline input: False
267+
Accept wildcard characters: False
268+
```
269+
270+
### -EFSkipMailGateway
271+
This parameter is reserved for internal Microsoft use.
272+
273+
```yaml
274+
Type: MultiValuedProperty
275+
Parameter Sets: (All)
276+
Aliases:
277+
Applicable: Exchange Online, Exchange Online Protection
278+
279+
Required: False
280+
Position: Named
281+
Default value: None
282+
Accept pipeline input: False
283+
Accept wildcard characters: False
284+
```
285+
286+
### -EFTestMode
287+
This parameter is reserved for internal Microsoft use.
288+
289+
```yaml
290+
Type: Boolean
291+
Parameter Sets: (All)
292+
Aliases:
293+
Applicable: Exchange Online, Exchange Online Protection
294+
295+
Required: False
296+
Position: Named
297+
Default value: None
298+
Accept pipeline input: False
299+
Accept wildcard characters: False
300+
```
301+
302+
### -EFUsers
303+
The EFUsers parameter specifies the recipients that Enhanced Filtering for Connectors applies to. The default value is blank ($null), which means Enhanced Filtering for Connectors is applied to all recipients.
304+
305+
You can specify multiple recipient email addresses separated by commas.
306+
307+
```yaml
308+
Type: MultiValuedProperty
309+
Parameter Sets: (All)
310+
Aliases:
311+
Applicable: Exchange Online, Exchange Online Protection
312+
313+
Required: False
314+
Position: Named
315+
Default value: None
316+
Accept pipeline input: False
317+
Accept wildcard characters: False
318+
```
319+
213320
### -Enabled
214321
The Enabled parameter enables or disables the connector. Valid input for this parameter is $true or $false. The default value is $true.
215322
@@ -276,6 +383,22 @@ Accept pipeline input: False
276383
Accept wildcard characters: False
277384
```
278385
386+
### -ScanAndDropRecipients
387+
This parameter is reserved for internal Microsoft use.
388+
389+
```yaml
390+
Type: MultiValuedProperty
391+
Parameter Sets: (All)
392+
Aliases:
393+
Applicable: Exchange Online, Exchange Online Protection
394+
395+
Required: False
396+
Position: Named
397+
Default value: None
398+
Accept pipeline input: False
399+
Accept wildcard characters: False
400+
```
401+
279402
### -SenderIPAddresses
280403
The SenderIPAddresses parameter specifies the remote IP addresses from which this connector accepts messages. You enter the IP addresses using the following syntax:
281404

exchange/exchange-ps/exchange/mail-flow/Set-InboundConnector.md

Lines changed: 132 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,28 @@ For information about the parameter sets in the Syntax section below, see [Excha
2323

2424
```
2525
Set-InboundConnector [-Identity] <InboundConnectorIdParameter>
26-
[-AssociatedAcceptedDomains <MultiValuedProperty>] [-CloudServicesMailEnabled <Boolean>]
27-
[-Comment <String>] [-Confirm] [-ConnectorSource <TenantConnectorSource>]
28-
[-ConnectorType <TenantConnectorType>] [-Enabled <Boolean>] [-Name <String>]
29-
[-RequireTls <Boolean>] [-RestrictDomainsToCertificate <Boolean>]
30-
[-RestrictDomainsToIPAddresses <Boolean>] [-SenderDomains <MultiValuedProperty>]
31-
[-SenderIPAddresses <MultiValuedProperty>] [-TlsSenderCertificateName <TlsCertificate>]
32-
[-TreatMessagesAsInternal <Boolean>] [-WhatIf] [<CommonParameters>]
26+
[-AssociatedAcceptedDomains <MultiValuedProperty>]
27+
[-CloudServicesMailEnabled <Boolean>]
28+
[-Comment <String>]
29+
[-Confirm]
30+
[-ConnectorSource <TenantConnectorSource>]
31+
[-ConnectorType <TenantConnectorType>]
32+
[-EFSkipIPs <MultiValuedProperty>]
33+
[-EFSkipLastIP <Boolean>]
34+
[-EFSkipMailGateway <MultiValuedProperty>]
35+
[-EFTestMode <Boolean>]
36+
[-EFUsers <MultiValuedProperty>]
37+
[-Enabled <Boolean>]
38+
[-Name <String>]
39+
[-RequireTls <Boolean>]
40+
[-RestrictDomainsToCertificate <Boolean>]
41+
[-RestrictDomainsToIPAddresses <Boolean>]
42+
[-ScanAndDropRecipients <MultiValuedProperty>]
43+
[-SenderDomains <MultiValuedProperty>]
44+
[-SenderIPAddresses <MultiValuedProperty>]
45+
[-TlsSenderCertificateName <TlsCertificate>]
46+
[-TreatMessagesAsInternal <Boolean>]
47+
[-WhatIf] [<CommonParameters>]
3348
```
3449

3550
## DESCRIPTION
@@ -188,6 +203,100 @@ Accept pipeline input: False
188203
Accept wildcard characters: False
189204
```
190205
206+
### -EFSkipIPs
207+
the EFSkipIPs parameter specifies the source IP addresses to skip in Enhanced Filtering for Connectors when the EFSkipLastIP parameter value is $false. Valid values are:
208+
209+
- A single IP address: For example, 192.168.1.1.
210+
211+
- An IP address range: For example, 192.168.0.1-192.168.0.254.
212+
213+
- Classless Inter-Domain Routing (CIDR) IP: For example, 192.168.3.1/24
214+
215+
You can specify multiple IP addresses or address range entries separated by commas.
216+
217+
```yaml
218+
Type: MultiValuedProperty
219+
Parameter Sets: (All)
220+
Aliases:
221+
Applicable: Exchange Online, Exchange Online Protection
222+
223+
Required: False
224+
Position: Named
225+
Default value: None
226+
Accept pipeline input: False
227+
Accept wildcard characters: False
228+
```
229+
230+
### -EFSkipLastIP
231+
The EFSkipIPs parameter specifies the behavior of Enhanced Filtering for Connectors. Valid values are:
232+
233+
- $true: Only the last message source is skipped.
234+
235+
- $false: Skip the source IP addresses specified by the EFSkipIPs parameter. If no IP addresses are specified, Enhanced Filtering for Connectors is disabled on the connector. This is the default value.
236+
237+
```yaml
238+
Type: Boolean
239+
Parameter Sets: (All)
240+
Aliases:
241+
Applicable: Exchange Online, Exchange Online Protection
242+
243+
Required: False
244+
Position: Named
245+
Default value: None
246+
Accept pipeline input: False
247+
Accept wildcard characters: False
248+
```
249+
250+
### -EFSkipMailGateway
251+
This parameter is reserved for internal Microsoft use.
252+
253+
```yaml
254+
Type: MultiValuedProperty
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+
266+
### -EFTestMode
267+
This parameter is reserved for internal Microsoft use.
268+
269+
```yaml
270+
Type: Boolean
271+
Parameter Sets: (All)
272+
Aliases:
273+
Applicable: Exchange Online, Exchange Online Protection
274+
275+
Required: False
276+
Position: Named
277+
Default value: None
278+
Accept pipeline input: False
279+
Accept wildcard characters: False
280+
```
281+
282+
### -EFUsers
283+
The EFUsers parameter specifies the recipients that Enhanced Filtering for Connectors applies to. The default value is blank ($null), which means Enhanced Filtering for Connectors is applied to all recipients.
284+
285+
You can specify multiple recipient email addresses separated by commas.
286+
287+
```yaml
288+
Type: MultiValuedProperty
289+
Parameter Sets: (All)
290+
Aliases:
291+
Applicable: Exchange Online, Exchange Online Protection
292+
293+
Required: False
294+
Position: Named
295+
Default value: None
296+
Accept pipeline input: False
297+
Accept wildcard characters: False
298+
```
299+
191300
### -Enabled
192301
The Enabled parameter enables or disables the connector. Valid input for this parameter is $true or $false. The default value is $true.
193302
@@ -270,6 +379,22 @@ Accept pipeline input: False
270379
Accept wildcard characters: False
271380
```
272381
382+
### -ScanAndDropRecipients
383+
This parameter is reserved for internal Microsoft use.
384+
385+
```yaml
386+
Type: MultiValuedProperty
387+
Parameter Sets: (All)
388+
Aliases:
389+
Applicable: Exchange Online, Exchange Online Protection
390+
391+
Required: False
392+
Position: Named
393+
Default value: None
394+
Accept pipeline input: False
395+
Accept wildcard characters: False
396+
```
397+
273398
### -SenderDomains
274399
The SenderDomains parameter specifies the remote domains from which this connector accepts messages, thereby limiting its scope. You can use a wildcard character to specify all subdomains of a specified domain, as shown in the following example: \*.contoso.com. However, you can't embed a wildcard character, as shown in the following example: domain.\*.contoso.com.
275400

exchange/exchange-ps/exchange/mail-flow/Set-OutboundConnector.md

Lines changed: 21 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -22,15 +22,27 @@ For information about the parameter sets in the Syntax section below, see [Excha
2222
## SYNTAX
2323

2424
```
25-
Set-OutboundConnector [-Identity] <OutboundConnectorIdParameter> [-AllAcceptedDomains <Boolean>]
26-
[-CloudServicesMailEnabled <Boolean>] [-Comment <String>] [-Confirm]
27-
[-ConnectorSource <TenantConnectorSource>] [-ConnectorType <TenantConnectorType>]
28-
[-Enabled <Boolean>] [-IsTransportRuleScoped <Boolean>] [-IsValidated <Boolean>]
29-
[-LastValidationTimestamp <DateTime>] [-Name <String>] [-RecipientDomains <MultiValuedProperty>]
30-
[-RouteAllMessagesViaOnPremises <Boolean>] [-SmartHosts <MultiValuedProperty>]
31-
[-TestMode <Boolean>] [-TlsDomain <SmtpDomainWithSubdomains>]
32-
[-TlsSettings <TlsAuthLevel>] [-UseMXRecord <Boolean>]
33-
[-ValidationRecipients <String[]>] [-WhatIf] [<CommonParameters>]
25+
Set-OutboundConnector [-Identity] <OutboundConnectorIdParameter>
26+
[-AllAcceptedDomains <Boolean>]
27+
[-CloudServicesMailEnabled <Boolean>]
28+
[-Comment <String>]
29+
[-Confirm]
30+
[-ConnectorSource <TenantConnectorSource>]
31+
[-ConnectorType <TenantConnectorType>]
32+
[-Enabled <Boolean>]
33+
[-IsTransportRuleScoped <Boolean>]
34+
[-IsValidated <Boolean>]
35+
[-LastValidationTimestamp <DateTime>]
36+
[-Name <String>]
37+
[-RecipientDomains <MultiValuedProperty>]
38+
[-RouteAllMessagesViaOnPremises <Boolean>]
39+
[-SmartHosts <MultiValuedProperty>]
40+
[-TestMode <Boolean>]
41+
[-TlsDomain <SmtpDomainWithSubdomains>]
42+
[-TlsSettings <TlsAuthLevel>]
43+
[-UseMXRecord <Boolean>]
44+
[-ValidationRecipients <String[]>]
45+
[-WhatIf] [<CommonParameters>]
3446
```
3547

3648
## DESCRIPTION

exchange/exchange-ps/exchange/users-and-groups/Set-User.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -737,7 +737,10 @@ Accept wildcard characters: False
737737
### -PermanentlyClearPreviousMailboxInfo
738738
The PermanentlyClearPreviousMailboxInfo switch specifies whether to clear the Exchange mailbox attributes on a user. You don't need to specify a value with this switch.
739739

740-
Clearing these attributes might be required in mailbox move and re-licensing scenarios between on-premises Exchange and Office 365.
740+
Clearing these attributes might be required in mailbox move and re-licensing scenarios between on-premises Exchange and Office 365. For more information, see [Permanently Clear Previous Mailbox Info](https://techcommunity.microsoft.com/t5/exchange-team-blog/permanently-clear-previous-mailbox-info/ba-p/607619).
741+
742+
> [!CAUTION]
743+
> This switch permanently deletes the existing cloud mailbox and its associated archive, prevents you from reconnecting to the mailbox, and prevents you from recovering content from the mailbox.
741744

742745
```yaml
743746
Type: SwitchParameter

0 commit comments

Comments
 (0)