Commands › Exchange Online
New-InboundConnector
Create a new Inbound connector in your cloud-based organization. **Note**: Creation of inbound connectors is restricted in Microsoft 365 E5 developer subscriptions. Opening a support ticket in affected organizations won't help.
Quick start script
# New-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)
New-InboundConnector -Name <String> -SenderDomains <MultiValuedProperty> -WhatIf
New-InboundConnector -Name <String> -SenderDomains <MultiValuedProperty>
# 4. Verify and diff
$after = Get-InboundConnector
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
New-InboundConnector [-Name] <String> -SenderDomains <MultiValuedProperty>
[-AssociatedAcceptedDomains <MultiValuedProperty>]
[-ClientHostNames <MultiValuedProperty>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-EFSkipIPs <MultiValuedProperty>]
[-EFSkipLastIP <Boolean>]
[-EFSkipMailGateway <MultiValuedProperty>]
[-EFTestMode <Boolean>]
[-EFUsers <MultiValuedProperty>]
[-Enabled <Boolean>]
[-RequireTls <Boolean>]
[-RestrictDomainsToCertificate <Boolean>]
[-RestrictDomainsToIPAddresses <Boolean>]
[-ScanAndDropRecipients <MultiValuedProperty>]
[-SenderIPAddresses <MultiValuedProperty>]
[-TlsSenderCertificateName <TlsCertificate>]
[-TreatMessagesAsInternal <Boolean>]
[-TrustedOrganizations <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]Parameters (24)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Name | String | yes | The Name parameter specifies a descriptive name for the connector. |
| -SenderDomains | MultiValuedProperty | yes | 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... |
| -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... | |
| -ClientHostNames | MultiValuedProperty | {{ Fill ClientHostNames Description }} | |
| -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 the category for the source domains that the connector accepts messages for. Valid values are: | |
| -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: | |
| -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. | |
| -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). You can specify multiple Microsoft 365 organizations... | |
| -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. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.