Export (0) Print
Expand All
Expand Minimize

Set-InboundConnector

Exchange 2013
 

Applies to: Exchange Online Protection, Exchange Online

Topic Last Modified: 2014-01-08

This cmdlet is available only in the cloud-based service.

Use the Set-InboundConnector cmdlet to change an existing Inbound connector in your cloud-based organization.

For information about the parameter sets in the Syntax section below, see Syntax.

Set-InboundConnector -Identity <InboundConnectorIdParameter> [-AssociatedAcceptedDomains <MultiValuedProperty>] [-BypassValidation <$true | $false>] [-CloudServicesMailEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectorSource <Default | Migrated | HybridWizard>] [-ConnectorType <OnPremises | Partner>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Name <String>] [-RequireTls <$true | $false>] [-RestrictDomainsToCertificate <$true | $false>] [-RestrictDomainsToIPAddresses <$true | $false>] [-SenderDomains <MultiValuedProperty>] [-SenderIPAddresses <MultiValuedProperty>] [-TlsSenderCertificateName <TlsCertificate>] [-WhatIf [<SwitchParameter>]]

This example makes the following configuration changes to the existing Inbound connector named Contoso.com Inbound Connector.

  • Require TLS transmission for all incoming messages on the connector.

  • Require that the TLS certificate that is used to encrypt communications contain the domain name contoso.com

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

Inbound connectors accept email messages from remote domains that require specific configuration options.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Inbound and Outbound connectors" entry in the Feature permissions in Exchange Online topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.InboundConnectorIdParameter

The Identity parameter specifies the Inbound connector you want to change.

AssociatedAcceptedDomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The AssociatedAcceptedDomains parameter specifies the accepted domains that the connector applies to, thereby limiting its scope. For example, you can apply the connector to a specific accepted domain in your organization, such as contoso.com.

BypassValidation

Optional

System.Boolean

This parameter is reserved for internal Microsoft use.

CloudServicesMailEnabled

Optional

System.Boolean

Set to $true to enable this connector to receive messages from the cloud service.

Comment

Optional

System.String

The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note".

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

ConnectorSource

Optional

Microsoft.Exchange.Data.TenantConnectorSource

The ConnectorSource parameter specifies how the connector was created. Valid input for this parameter includes the following values:

  • Default   The connector is manually created.

  • HybridWizard   The connector is created automatically by the Hybrid Configuration Wizard.

  • Migrated   The connector was originally created in Microsoft Forefront Online Protection for Exchange.

The default value for connectors you create is Default. It isn’t recommended that you change this value.

ConnectorType

Optional

Microsoft.Exchange.Data.TenantConnectorType

The ConnectorType parameter specifies a category for the domains that are serviced by the connector. Valid input for this parameter includes the following values:

  • Partner   The connector services domains that are external to your organization.

  • OnPremises   The connector services domains that are used by your on-premises organization. Use this value for accepted domains in your cloud-based organization that are also specified by the SenderDomains parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

This parameter is reserved for internal Microsoft use.

Enabled

Optional

System.Boolean

The Enabled parameter enables or disables the connector. Valid input for this parameter is $true or $false. The default value is $true.

Name

Optional

System.String

The Name parameter specifies a descriptive name for the connector.

RequireTls

Optional

System.Boolean

The RequireTLS parameter specifies that all messages received by this connector require TLS transmission. Valid values for this parameter are $true or $false. The default value is $false. When the RequireTLS parameter is set to $true, all messages received by this connector require TLS transmission.

RestrictDomainsToCertificate

Optional

System.Boolean

The RestrictDomainsToCertificate parameter, when set to $true, causes the connector to reject mail that originates from a namespace not specified by the TlsSenderCertificateName parameter.

RestrictDomainsToIPAddresses

Optional

System.Boolean

The RestrictDomainsToIPAddresses parameter, when set to $true, automatically rejects mail from the domains specified by the SenderDomains parameter if the mail originates from an IP address that isn't specified by the SenderIPAddresses parameter.

Valid input for this parameter is $true or $false. The default value is $false.

SenderDomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

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.

You can specify multiple domains separated by commas.

SenderIPAddresses

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The SenderIPAddresses parameter specifies the remote IP addresses from which this connector accepts messages. You enter the IP addresses using the following syntax:

  • Single IP   For example, 192.168.1.1.

  • CIDR IP   You can use Classless InterDomain Routing (CIDR). For example, 192.168.0.1/25.

You can specify multiple IP addresses separated by commas.

TlsSenderCertificateName

Optional

Microsoft.Exchange.Data.TlsCertificate

The TlsSenderCertificateName parameter specifies the certificate used by the sender’s domain when the RequireTls parameter is set to $true. Valid input for the TlsSenderCertificateName 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.

You can't embed a wildcard character, as shown in the following example: domain.*.contoso.com.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft