New-InboundConnector
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet New-InboundConnector, um einen neuen eingehenden Connector in Ihrer cloudbasierten Organisation zu erstellen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-InboundConnector
[-Name] <String>
-SenderDomains <MultiValuedProperty>
[-AssociatedAcceptedDomains <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>] Beschreibung
Eingehende Connectors akzeptieren E-Mails von Remotedomänen, für die spezifische Konfigurationsoptionen erforderlich sind.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
New-InboundConnector -Name "Contoso Inbound Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $trueIn diesem Beispiel wird der eingehende Connector "Contoso Inbound Connector" mit den folgenden Eigenschaften erstellt:
- Er prüft auf eingehende Verbindungen von der Domäne "contoso.com" und allen Unterdomänen.
- Er akzeptiert nur E-Mails von "contoso.com" und aus dem IP-Bereich 192.168.0.1/25. Er weist E-Mails von "contoso.com" zurück, wenn sie von einer anderen IP-Adresse stammen.
Beispiel 2
New-InboundConnector -Name "Contoso Inbound Secure Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true -RequireTLS $true -TlsSenderCertificateName *.contoso.comIn diesem Beispiel wird der eingehende Connector "Contoso Inbound Secure Connector" erstellt, der für alle Nachrichten eine TLS-Übertragung erfordert.
Parameter
-AssociatedAcceptedDomains
Der AssociatedAcceptedDomains-Parameter schränkt die Quelldomänen, die den Connector verwenden, auf die angegebenen akzeptierten Domänen ein. Ein gültiger Wert ist eine SMTP-Domäne, die als akzeptierte Domäne in Ihrem Microsoft 365-organization konfiguriert ist.
Es können mehrere Werte durch Kommata getrennt angegeben werden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CloudServicesMailEnabled
Hinweis: Es wird empfohlen, diesen Parameter nicht zu verwenden, es sei denn, Sie werden vom Microsoft-Kundendienst und -Support oder von einer bestimmten Produktdokumentation dazu aufgefordert. Verwenden Sie stattdessen den Assistenten für die Hybridkonfiguration, um den E-Mail-Fluss zwischen Ihren lokalen und Cloudorganisationen zu konfigurieren. Weitere Informationen finden Sie unter Assistent für die Hybridkonfiguration.
Der Parameter CloudServicesMailEnabled gibt an, ob der Connector für den hybriden E-Mail-Fluss zwischen einer lokalen Exchange-Umgebung und Microsoft 365 verwendet wird. Dieser Parameter steuert insbesondere, wie bestimmte interne X-MS-Exchange-Organization-*-Nachrichtenheader in Nachrichten behandelt werden, die zwischen akzeptierten Domänen in der lokalen und cloudbasierten Organisation gesendet werden. Diese Header werden zusammen als standortübergreifende Header bezeichnet.
Gültige Werte sind:
- $true: Der Connector wird für den Nachrichtenfluss in Hybridorganisationen verwendet, sodass standortübergreifende Header in Nachrichten, die über den Connector fließen, beibehalten oder heraufgestuft werden. Dies ist der Standardwert für Connectors, die vom Assistenten für die Hybridkonfiguration erstellt werden. Bestimmte X-MS-Exchange-Organization-*-Header in ausgehenden Nachrichten, die von einer Seite der Hybrid-organization an die andere gesendet werden, werden in X-MS-Exchange-CrossPremises-*-Header konvertiert und dadurch in Nachrichten beibehalten. X-MS-Exchange-CrossPremises-*-Header in eingehenden Nachrichten, die auf einer Seite der Hybrid-organization von der anderen empfangen werden, werden zu X-MS-Exchange-Organization-*-Headern heraufgestuft. Diese höher gestuften Header ersetzen alle Instanzen der gleichen X-MS-Exchange-Organization-*-Header, die bereits in Nachrichten vorhanden sind.
- $false: Der Connector wird in Hybridorganisationen nicht für den Nachrichtenfluss verwendet, sodass alle standortübergreifenden Header aus Nachrichten entfernt werden, die über den Connector fließen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Comment
Der „Comment“-Parameter gibt einen optionalen Kommentar an. Wenn Sie einen Wert angeben, der Leerzeichen enthält, setzen Sie den Wert in Anführungszeichen ("), z. B. "This is an admin note".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Confirm
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorSource
Der Parameter ConnectorSource gibt an, wie der Connector erstellt wird. Gültige Eingabewerte für diesen Parameter sind:
- Default: Der Connector wird manuell erstellt. Dies ist der Standardwert.
- HybridWizard: Der Connector wird automatisch vom Assistenten für Hybridkonfigurationen erstellt.
- Migrated: Der Connector wurde ursprünglich in Microsoft Forefront Online Protection für Exchange erstellt.
Es wird empfohlen, diesen Wert nicht zu ändern.
| Type: | TenantConnectorSource |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorType
Der ConnectorType-Parameter gibt die Kategorie für die Quelldomänen an, für die der Connector Nachrichten akzeptiert. Gültige Werte sind:
- Partner: Externe Partner oder Dienste.
- OnPremises: Ihre lokale E-Mail-organization. Verwenden Sie diesen Wert für akzeptierte Domänen in Ihrer cloudbasierten Organisation, die auch durch den Parameter SenderDomains angegeben werden.
| Type: | TenantConnectorType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipIPs
Der EFSkipIPs-Parameter gibt die Quell-IP-Adressen an, die in Erweiterte Filterung für Connectors übersprungen werden sollen, wenn der Wert des EFSkipLastIP-Parameters $false ist. Gültige Werte sind:
- Einzelne IP-Adresse: Beispiel: 192.168.1.1.
- IP-Adressbereich: Beispiel: 192.168.0.1-192.168.0.254.
- CIDR-IP-Adressbereich (Classless InterDomain Routing): Beispiel: 192.168.3.1/24.
Es können mehrere Werte durch Kommata getrennt angegeben werden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipLastIP
Der EFSkipIPs-Parameter gibt das Verhalten der erweiterten Filterung für Connectors an. Gültige Werte sind:
- $true: Nur die letzte Nachrichtenquelle wird übersprungen.
- $false: Überspringen Sie die durch den EFSkipIPs-Parameter angegebenen Quell-IP-Adressen. Wenn keine IP-Adressen angegeben sind, ist die erweiterte Filterung für Connectors auf dem Connector deaktiviert. Dies ist der Standardwert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipMailGateway
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFTestMode
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFUsers
Der EFUsers-Parameter gibt die Empfänger an, für die die erweiterte Filterung für Connectors gilt. Der Standardwert ist leer ($null), was bedeutet, dass die erweiterte Filterung für Connectors auf alle Empfänger angewendet wird.
Die E-Mail-Adressen mehrerer Empfänger können durch Kommas getrennt angegeben werden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Enabled
Der Parameter Enabled aktiviert oder deaktiviert den Connector. Gültige Werte sind:
- $true: Der Connector ist aktiviert. Dies ist der Standardwert.
- $false: Der Connector ist deaktiviert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Der Parameter Name gibt einen beschreibenden Namen für den Connector an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RequireTls
Der RequireTLS-Parameter gibt an, ob die TLS-Übertragung für alle Nachrichten erforderlich ist, die vom Connector empfangen werden. Gültige Werte sind:
- $true: Lehnen Sie Nachrichten ab, wenn sie nicht über TLS gesendet werden. Dies ist der Standardwert.
- $false: Nachrichten zulassen, wenn sie nicht über TLS gesendet werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToCertificate
Der Parameter RestrictDomainsToCertificate gibt an, ob der Subject-Wert des TLS-Zertifikats überprüft wird, bevor Nachrichten den Connector verwenden können. Gültige Werte sind:
- $true: E-Mail darf den Connector nur verwenden, wenn der Subject-Wert des TLS-Zertifikats, das der Quell-E-Mail-Server für die Authentifizierung verwendet, dem Parameterwert TlsSenderCertificateName entspricht.
- $false: Der Antragstellerwert des TLS-Zertifikats, das der Quell-E-Mail-Server für die Authentifizierung verwendet, steuert nicht, ob E-Mails aus dieser Quelle den Connector verwenden. Dies ist der Standardwert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToIPAddresses
Der Parameter RestrictDomainsToIPAddresses gibt an, ob E-Mails von unbekannten Quell-IP-Adressen abgelehnt werden sollen. Gültige Werte sind:
- $true: E-Mails von Domänen, die durch den Parameter SenderDomains angegeben werden, automatisch ablehnen, wenn die Quell-IP-Adresse nicht auch durch den SenderIPAddress-Parameter angegeben wird.
- $false: E-Mails von Domänen, die vom Parameter SenderDomains basierend auf der Quell-IP-Adresse angegeben werden, nicht automatisch ablehnen. Dies ist der Standardwert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ScanAndDropRecipients
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderDomains
Der Parameter SenderDomains gibt die Quelldomänen an, für die der Connector Nachrichten akzeptiert. Ein gültiger Wert ist eine SMTP-Domäne. Platzhalter werden unterstützt, um eine Domäne und alle Unterdomänen (z. B. *.contoso.com) anzugeben, aber Sie können das Platzhalterzeichen nicht einbetten (z. B. domäne.*.contoso.com ist ungültig).
Mehrere Domänen können durch Kommata getrennt angegeben werden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderIPAddresses
Der Parameter SenderIPAddresses gibt die IPV4-Quell-IP-Adressen an, von denen der Connector Nachrichten akzeptiert. Gültige Werte sind:
- Einzelne IP-Adresse: Beispiel: 192.168.1.1.
- CIDR-IP-Adressbereich (Classless InterDomain Routing): Beispiel: 192.168.0.1/25. Gültige Subnetzmaskenwerte sind /24 bis /32.
Mehrere IP-Adressen können durch Kommas getrennt angegeben werden.
IPv6-Adressen werden nicht unterstützt.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TlsSenderCertificateName
Der Parameter TlsSenderCertificateName gibt das TLS-Zertifikat an, das verwendet wird, wenn der Wert des RequireTls-Parameters $true wird. Ein gültiger Wert ist eine SMTP-Domäne. Platzhalter werden unterstützt, um eine Domäne und alle Unterdomänen (z. B. *.contoso.com) anzugeben, aber Sie können das Platzhalterzeichen nicht einbetten (z. B. domäne.*.contoso.com ist ungültig).
| Type: | TlsCertificate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TreatMessagesAsInternal
Der Parameter TreatMessagesAsInternal gibt eine alternative Methode zum Identifizieren von Nachrichten an, die von einem lokalen organization als interne Nachrichten gesendet werden. Sie sollten diesen Parameter nur dann verwenden, wenn Ihre lokale organization Exchange nicht verwendet. Gültige Werte sind:
- $true: Nachrichten werden als intern betrachtet, wenn die Domäne des Absenders mit einer Domäne übereinstimmt, die in Microsoft 365 konfiguriert ist. Diese Einstellung ermöglicht den internen E-Mail-Fluss zwischen Microsoft 365 und lokalen Organisationen, für die Exchange Server 2010 oder höher nicht installiert ist. Diese Einstellung weist jedoch potenzielle Sicherheitsrisiken auf (z. B. wenn interne Nachrichten die Antispamfilterung umgehen). Gehen Sie daher beim Konfigurieren dieser Einstellung vorsichtig vor.
- $false: Nachrichten werden nicht als intern betrachtet. Dies ist der Standardwert.
In Hybridumgebungen müssen Sie diesen Parameter nicht verwenden, da der Hybridkonfigurations-Assistent automatisch die erforderlichen Einstellungen für den Eingehenden Connector in Microsoft 365 und den Sendeconnector im lokalen Exchange-organization (der Parameter CloudServicesMailEnabled) konfiguriert.
Hinweis: Sie können diesen Parameter nicht auf den Wert $true festlegen, wenn eine der folgenden Bedingungen zutrifft:
- Der Parameter CloudServicesMailEnabled wird auf den Wert $true festgelegt.
- Der ConnectorType-Parameterwert ist nicht OnPremises.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TrustedOrganizations
Der Parameter TrustedOrganizations gibt andere Microsoft 365-Organisationen an, bei denen es sich um vertrauenswürdige E-Mail-Quellen handelt (z. B. nach Übernahmen und Fusionen). Sie können mehrere Microsoft 365-Organisationen durch Kommas getrennt angeben.
Dieser Parameter funktioniert nur für den Nachrichtenfluss zwischen zwei Microsoft 365-Organisationen, sodass keine anderen Parameter verwendet werden.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.