Set-InboundConnector — usage, script and reference

Quick start script

# Set-InboundConnector — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-InboundConnector
$before | Format-List

# 3. Make the change (dry run first)
Set-InboundConnector -Identity <InboundConnectorIdParameter> -WhatIf
Set-InboundConnector -Identity <InboundConnectorIdParameter>

# 4. Verify and diff
$after = Get-InboundConnector
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-InboundConnector [-Identity] <InboundConnectorIdParameter>
 [-AssociatedAcceptedDomains <MultiValuedProperty>]
 [-CloudServicesMailEnabled <Boolean>]
 [-Comment <String>]
 [-Confirm]
 [-ConnectorSource <TenantConnectorSource>]
 [-ConnectorType <TenantConnectorType>]
 [-EFSkipIPs <MultiValuedProperty>]
 [-EFSkipLastIP <Boolean>]
 [-EFSkipMailGateway <MultiValuedProperty>]
 [-EFTestMode <Boolean>]
 [-EFUsers <MultiValuedProperty>]
 [-Enabled <Boolean>]
 [-Name <String>]
 [-RequireTls <Boolean>]
 [-RestrictDomainsToCertificate <Boolean>]
 [-RestrictDomainsToIPAddresses <Boolean>]
 [-ScanAndDropRecipients <MultiValuedProperty>]
 [-SenderDomains <MultiValuedProperty>]
 [-SenderIPAddresses <MultiValuedProperty>]
 [-TlsSenderCertificateName <TlsCertificate>]
 [-TreatMessagesAsInternal <Boolean>]
 [-TrustedOrganizations <MultiValuedProperty>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (24)

Parameter	Type	Required	What it controls
-Identity	InboundConnectorIdParameter	yes	The Identity parameter specifies the Inbound connector you want to change.
-AssociatedAcceptedDomains	MultiValuedProperty		The AssociatedAcceptedDomains parameter restricts the source domains that use the connector to the specified accepted domains. A valid value is an SMTP domain that's configured as an accepted domain in your Microsoft...
-CloudServicesMailEnabled	Boolean		Note: We recommend that you don't use this parameter unless you are directed to do so by Microsoft Customer Service and Support, or by specific product documentation. Instead, use the Hybrid Configuration wizard...
-Comment	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	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-ConnectorSource	TenantConnectorSource		The ConnectorSource parameter specifies how the connector is created. Valid input for this parameter includes the following values:
-ConnectorType	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:
-EFSkipIPs	MultiValuedProperty		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:
-EFSkipLastIP	Boolean		The EFSkipIPs parameter specifies the behavior of Enhanced Filtering for Connectors. Valid values are:
-EFSkipMailGateway	MultiValuedProperty		This parameter is reserved for internal Microsoft use.
-EFTestMode	Boolean		This parameter is reserved for internal Microsoft use.
-EFUsers	MultiValuedProperty		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.
-Enabled	Boolean		The Enabled parameter enables or disables the connector. Valid values are:
-Name	String		The Name parameter specifies a descriptive name for the connector.
-RequireTls	Boolean		The RequireTLS parameter specifies whether to require TLS transmission for all messages that are received by a Partner type connector. Valid values are:
-RestrictDomainsToCertificate	Boolean		The RestrictDomainsToCertificate parameter specifies whether the Subject value of the TLS certificate is checked before messages can use the Partner type connector. Valid values are:
-RestrictDomainsToIPAddresses	Boolean		The RestrictDomainsToIPAddresses parameter specifies whether to reject mail that comes from unknown source IP addresses for Partner type connectors. Valid values are:
-ScanAndDropRecipients	MultiValuedProperty		This parameter is reserved for internal Microsoft use.
-SenderDomains	MultiValuedProperty		The SenderDomains parameter specifies the source domains that a Partner type connector accepts messages for (limits the scope of a Partner type connector). A valid value is an SMTP domain. Wildcards are supported to...
-SenderIPAddresses	MultiValuedProperty		The SenderIPAddresses parameter specifies the source IPV4 IP addresses that the Partner type connector accepts messages from when the value of the RestrictDomainsToIPAddresses parameter is $true. Valid values are:
-TlsSenderCertificateName	TlsCertificate		The TlsSenderCertificateName parameter specifies the TLS certificate that's used when the value of the RequireTls parameter is $true. A valid value is an SMTP domain. Wildcards are supported to indicate a domain and...
-TreatMessagesAsInternal	Boolean		The TreatMessagesAsInternal parameter specifies an alternative method to identify messages sent from an on-premises organization as internal messages. You should only consider using this parameter when your...
-TrustedOrganizations	MultiValuedProperty		The TrustedOrganizations parameter specifies other Microsoft 365 organizations that are trusted mail sources (for example, after acquisitions and mergers). This parameter works only for mail flow between two...
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.