Skip to content

Commit 40d769a

Browse files
committed
SenderRewritingEnabled fixes
Per Issue #9976. Also other parameter description fixes for consistency.
1 parent 55f0d4e commit 40d769a

File tree

2 files changed

+40
-20
lines changed

2 files changed

+40
-20
lines changed

exchange/exchange-ps/exchange/New-OutboundConnector.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -81,9 +81,11 @@ Accept wildcard characters: False
8181
### -AllAcceptedDomains
8282
The AllAcceptedDomains parameter specifies whether the Outbound connector is used in hybrid organizations where message recipients are in accepted domains of the cloud-based organization. Valid values are:
8383
84-
- $true: The Outbound connector is used in hybrid organizations when message recipients are in an accepted domain of the cloud-based organization. You can only use this value when the ConnectorType parameter value is OnPremises.
84+
- $true: The Outbound connector is used in hybrid organizations when message recipients are in an accepted domain of the cloud-based organization. This setting requires OnPremises for the ConnectorType value.
8585
- $false: The Outbound connector isn't used in hybrid organizations. This is the default value.
8686
87+
This parameter is effective only for OnPremises connectors.
88+
8789
```yaml
8890
Type: Boolean
8991
Parameter Sets: (All)
@@ -269,10 +271,12 @@ Accept wildcard characters: False
269271
```
270272

271273
### -RouteAllMessagesViaOnPremises
272-
The RouteAllMessagesViaOnPremises parameter specifies that all messages serviced by this connector are first routed through the on-premises messaging system in hybrid organizations. Valid values are:
274+
The RouteAllMessagesViaOnPremises parameter specifies that all messages serviced by this connector are first routed through the on-premises email system in hybrid organizations. Valid values are:
275+
276+
- $true: Messages are routed through the on-premises email system. This setting requires OnPremises for the ConnectorType value.
277+
- $false: Messages aren't routed through the on-premises email system. This is the default value.
273278

274-
- $true: Messages are routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
275-
- $false: Messages aren't routed through the on-premises messaging system. This is the default value.
279+
This parameter is effective only for OnPremises connectors.
276280

277281
```yaml
278282
Type: Boolean
@@ -288,10 +292,12 @@ Accept wildcard characters: False
288292
```
289293

290294
### -SenderRewritingEnabled
291-
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewritting are rewritten for traffic to on-premises. This parameter is only effective for OnPremises connectors as Partner connectors already have SRS rewritting enabled. Valid values are:
295+
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewriting are rewritten for routing through the on-premises email system. Valid values are:
296+
297+
- $true: Messages are rewritten by SRS as needed before being routed through the on-premises email system. This setting requires OnPremises for the ConnectorType value.
298+
- $false: Messages aren't rewritten by SRS before being routed through the on-premises email system. This is the default value.
292299

293-
- $true: Messages are rewritten by SRS if they need to be before being routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
294-
- $false: Messages aren't rewritten by SRS before being routed through the on-premises messaging system. This is the default value.
300+
This parameter is effective only for OnPremises connectors.
295301

296302
```yaml
297303
Type: Boolean
@@ -310,7 +316,7 @@ Accept wildcard characters: False
310316
The SmartHosts parameter specifies the smart host that the Outbound connector uses to route mail. Valid values are:
311317

312318
- FQDN of a smart host server, a mail exchange (MX) record, or an address (A) record: For example, mail.contoso.com.
313-
- Single IP address: For example, 10.10.1.1
319+
- Single IP address: For example, 10.10.1.1.
314320
- Classless InterDomain Routing (CIDR) IP address range: For example, 192.168.0.1/25.
315321

316322
You can specify multiple value separated by commas: `"Value1","Value2",..."ValueN"`.
@@ -350,7 +356,11 @@ Accept wildcard characters: False
350356
```
351357

352358
### -TlsDomain
353-
The TlsDomain parameter specifies the domain name that the Outbound connector uses to verify the FQDN of the target certificate when establishing a TLS secured connection. This parameter is only used if the TlsSettings parameter is set to DomainValidation. Valid input for the TlsDomain parameter is an SMTP domain. 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
359+
The TlsDomain parameter specifies the domain name that the Outbound connector uses to verify the FQDN of the target certificate when establishing a TLS secured connection. A valid value for this parameter is an SMTP domain.
360+
361+
Wildcards are supported to specify all subdomains of a domain (for example, \*.contoso.com), but you can't embed the wildcard character within the domain (for example, domain.\*.contoso.com).
362+
363+
This parameter meaningful only when the TlsSettings value is DomainValidation.
354364

355365
```yaml
356366
Type: SmtpDomainWithSubdomains
@@ -390,7 +400,7 @@ Accept wildcard characters: False
390400
The UseMXRecord parameter enables or disables DNS routing for the connector. Valid values are:
391401

392402
- $true: The connector uses DNS routing (MX records in DNS) to deliver email. This is the default value.
393-
- $false: The connector delivers email to one or more smart hosts. When you use this value, you also need to specify the smart hosts by using the SmartHosts parameter in the same command.
403+
- $false: The connector delivers email to one or more smart hosts. This setting requires one or more smart hosts for the SmartHosts value.
394404

395405
```yaml
396406
Type: Boolean

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

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -85,9 +85,11 @@ Accept wildcard characters: False
8585
### -AllAcceptedDomains
8686
The AllAcceptedDomains parameter specifies whether the Outbound connector is used in hybrid organizations where message recipients are in accepted domains of the cloud-based organization. Valid values are:
8787
88-
- $true: The Outbound connector is used in hybrid organizations when message recipients are in an accepted domain of the cloud-based organization. You can only use this value when the ConnectorType parameter value is OnPremises.
88+
- $true: The Outbound connector is used in hybrid organizations when message recipients are in an accepted domain of the cloud-based organization. This setting requires OnPremises for the ConnectorType value.
8989
- $false: The Outbound connector isn't used in hybrid organizations. This is the default value.
9090
91+
This parameter is effective only for OnPremises connectors.
92+
9193
```yaml
9294
Type: Boolean
9395
Parameter Sets: (All)
@@ -317,10 +319,12 @@ Accept wildcard characters: False
317319
```
318320

319321
### -RouteAllMessagesViaOnPremises
320-
The RouteAllMessagesViaOnPremises parameter specifies that all messages serviced by this connector are first routed through the on-premises messaging system. Valid values are:
322+
The RouteAllMessagesViaOnPremises parameter specifies that all messages serviced by this connector are first routed through the on-premises email system. Valid values are:
323+
324+
- $true: Messages are routed through the on-premises email system. This setting requires OnPremises for the ConnectorType value.
325+
- $false: Messages aren't routed through the on-premises email system. This is the default value.
321326

322-
- $true: Messages are routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
323-
- $false: Messages aren't routed through the on-premises messaging system. This is the default value.
327+
This parameter is effective only for OnPremises connectors.
324328

325329
```yaml
326330
Type: Boolean
@@ -336,10 +340,12 @@ Accept wildcard characters: False
336340
```
337341

338342
### -SenderRewritingEnabled
339-
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewritting are rewritten for traffic to on-premises. This parameter is only effective for OnPremises connectors as Partner connectors already have SRS rewritting enabled. Valid values are:
343+
The SenderRewritingEnabled parameter specifies that all messages that normally qualify for SRS rewriting are rewritten for routing through the on-premises email system. Valid values are:
344+
345+
- $true: Messages are rewritten by SRS as needed before being routed through the on-premises email system. This setting requires OnPremises for the ConnectorType value.
346+
- $false: Messages aren't rewritten by SRS before being routed through the on-premises email system. This is the default value.
340347

341-
- $true: Messages are rewritten by SRS if they need to be before being routed through the on-premises messaging system. This setting requires you to set the ConnectorType parameter to the value OnPremises in the same command.
342-
- $false: Messages aren't rewritten by SRS before being routed through the on-premises messaging system. This is the default value.
348+
This parameter is effective only for OnPremises connectors.
343349

344350
```yaml
345351
Type: Boolean
@@ -358,7 +364,7 @@ Accept wildcard characters: False
358364
The SmartHosts parameter specifies the smart host that the Outbound connector uses to route mail. Valid values are:
359365

360366
- FQDN of a smart host server, a mail exchange (MX) record, or an address (A) record: For example, mail.contoso.com.
361-
- Single IP address: For example, 10.10.1.1
367+
- Single IP address: For example, 10.10.1.1.
362368
- Classless InterDomain Routing (CIDR) IP address range: For example, 192.168.0.1/25.
363369

364370
You can specify multiple value separated by commas: `"Value1","Value2",..."ValueN"`.
@@ -398,7 +404,11 @@ Accept wildcard characters: False
398404
```
399405

400406
### -TlsDomain
401-
The TlsDomain parameter specifies the domain name that the Outbound connector uses to verify the FQDN of the target certificate when establishing a TLS secured connection. This parameter is only used if the TlsSettings parameter is set to DomainValidation. Valid input for the TlsDomain parameter is an SMTP domain. 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
407+
The TlsDomain parameter specifies the domain name that the Outbound connector uses to verify the FQDN of the target certificate when establishing a TLS secured connection. A valid value for this parameter is an SMTP domain.
408+
409+
Wildcards are supported to specify all subdomains of a domain (for example, \*.contoso.com), but you can't embed the wildcard character within the domain (for example, domain.\*.contoso.com).
410+
411+
This parameter meaningful only when the TlsSettings value is DomainValidation.
402412

403413
```yaml
404414
Type: SmtpDomainWithSubdomains
@@ -438,7 +448,7 @@ Accept wildcard characters: False
438448
The UseMXRecord parameter enables or disables DNS routing for the connector. Valid values are:
439449

440450
- $true: The connector uses DNS routing (MX records in DNS) to deliver email. This is the default value.
441-
- $false: The connector delivers email to one or more smart hosts. When you use this value, you also need to specify the smart hosts by using the SmartHosts parameter in the same command.
451+
- $false: The connector delivers email to one or more smart hosts. This setting requires one or more smart hosts for the SmartHosts value.
442452

443453
```yaml
444454
Type: Boolean

0 commit comments

Comments
 (0)