Freigeben über


Set-InboundConnector

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Mit dem Cmdlet Set-InboundConnector können Sie einen vorhandenen eingehenden Connector in Ihrer cloudbasierten Organisation ändern.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

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>]

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

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

In diesem Beispiel werden die folgenden Konfigurationsänderungen am vorhandenen eingehenden Connector namens "Contoso.com Inbound Connector" vorgenommen.

Anfordern der TLS-Übertragung für alle eingehenden Nachrichten auf dem Connector.

Anfordern, dass das zum Verschlüsseln der Kommunikation verwendete TLS-Zertifikat den Domänennamen "contoso.com" enthält

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 Parameter ConnectorType gibt eine Kategorie für die vom Connector bearbeiteten Domänen an. Gültige Eingabewerte für diesen Parameter sind:

  • Partner: Der Connector bearbeitet Domänen außerhalb Ihrer Organisation.
  • OnPremises: Der Connector bearbeitet Domänen, die von Ihrer lokalen Organisation verwendet werden. 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

-Identity

Der Parameter Identity gibt den eingehenden Connector an, den Sie ändern möchten.

Type:InboundConnectorIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
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:Named
Default value:None
Required:False
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:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderIPAddresses

Der Parameter SenderIPAddresses gibt die IPV4-Remote-IP-Adressen an, von denen dieser Connector Nachrichten akzeptiert. IPv6-Adressen werden nicht unterstützt. 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.

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

-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). Dieser Parameter funktioniert nur für den Nachrichtenfluss zwischen zwei Microsoft 365-Organisationen, sodass keine anderen Parameter verwendet werden.

Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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.