Freigeben über


New-OutboundConnector

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet New-OutboundConnector, um einen neuen ausgehenden Connectors 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-OutboundConnector
   [-Name] <String>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-LinkForModifiedConnector <Guid>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SenderRewritingEnabled <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Ausgehende Connectors senden E-Mails an 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-OutboundConnector -Name "Contoso Outbound Connector" -RecipientDomains *.contoso.com -TlsSettings DomainValidation -TlsDomain *.contoso.com

In diesem Beispiel wird der ausgehende Connector "Contoso Outbound Connector" mit den folgenden Eigenschaften erstellt:

  • Es sendet Nachrichten an Empfänger in der Domäne "contoso.com" und in allen Unterdomänen.
  • Er verwendet die TLS-Verschlüsselung und die Zertifikatverifizierung für E-Mails, die an die Domäne "contoso.com" und alle Unterdomänen weitergeleitet werden

Parameter

-AllAcceptedDomains

Der Parameter AllAcceptedDomains gibt an, ob der Ausgehende Connector in Hybridorganisationen verwendet wird, in denen sich Nachrichtenempfänger in akzeptierten Domänen der cloudbasierten Organisation befinden. Gültige Werte sind:

  • $true: Der ausgehende Connector wird in Hybridorganisationen verwendet, wenn sich Nachrichtenempfänger in einer akzeptierten Domäne der cloudbasierten Organisation befinden. Diese Einstellung erfordert OnPremises für den ConnectorType-Wert.
  • $false: Der ausgehende Connector wird in Hybridorganisationen nicht verwendet. Dies ist der Standardwert.

Dieser Parameter ist nur für OnPremises-Connectors gültig.

Type:Boolean
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 von Microsoft Kundendienst und Support oder 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 Hybridorganisation 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 Hybridorganisation 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 den Connector durchlaufen.
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 Werte sind:

  • Default: Der Connector wird manuell erstellt. Dies ist der Standardwert, wenn Sie dieses Cmdlet verwenden, und es wird empfohlen, diesen Wert nicht zu ändern.
  • 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.
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 Werte sind:

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

-Enabled

Der Parameter Enabled gibt an, ob der ausgehende Connector aktiviert oder deaktiviert werden soll. 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

-IsTransportRuleScoped

Der Parameter IsTransportRuleScoped gibt an, ob der Ausgehende Connector einer Transportregel (auch als Nachrichtenflussregel bezeichnet) zugeordnet ist. Gültige Werte sind:

  • $true: Der Connector ist einer Transportregel zugeordnet.
  • $false: Der Connector ist keiner Transportregel zugeordnet. Dies ist der Standardwert.

Sie können eine Transportregel auf einen ausgehenden Connector festlegen, indem Sie den Parameter RouteMessageOutboundConnector im New-TransportRule- oder Set-TransportRule-Cmdlets verwenden. Nachrichten, die den Bedingungen der Transportregel entsprechen, werden mithilfe des angegebenen ausgehenden Connectors an ihre Ziele weitergeleitet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-LinkForModifiedConnector

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Guid
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 den eindeutigen Namen für den Connector an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RecipientDomains

Der Parameter RecipientDomains gibt die Domänen an, an die der ausgehende Connector E-Mails weitergibt. Mehrere Domänen können durch Kommata getrennt angegeben werden.

Sie können ein Platzhalterzeichen verwenden, um alle Unterdomänen einer bestimmten Domäne anzugeben (siehe das folgende Beispiel): *.contoso.com. Sie können jedoch kein Wildcardzeichen einbetten, wie im folgenden Beispiel gezeigt: domain.*.contoso.com.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RouteAllMessagesViaOnPremises

Der Parameter RouteAllMessagesViaOnPremises gibt an, dass alle Nachrichten, die von diesem Connector verarbeitet werden, zuerst über das lokale E-Mail-System in Hybridorganisationen weitergeleitet werden. Gültige Werte sind:

  • $true: Nachrichten werden über das lokale E-Mail-System weitergeleitet. Diese Einstellung erfordert OnPremises für den ConnectorType-Wert.
  • $false: Nachrichten werden nicht über das lokale E-Mail-System weitergeleitet. Dies ist der Standardwert.

Dieser Parameter ist nur für OnPremises-Connectors gültig.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderRewritingEnabled

Der Parameter SenderRewritingEnabled gibt an, dass alle Nachrichten, die normalerweise für srs rewriting qualifiziert sind, für das Routing über das lokale E-Mail-System umgeschrieben werden. Gültige Werte sind:

  • $true: Nachrichten werden von SRS nach Bedarf umgeschrieben, bevor sie über das lokale E-Mail-System weitergeleitet werden. Diese Einstellung erfordert OnPremises für den ConnectorType-Wert.
  • $false: Nachrichten werden nicht von SRS umgeschrieben, bevor sie über das lokale E-Mail-System weitergeleitet werden. Dies ist der Standardwert.

Dieser Parameter ist nur für OnPremises-Connectors gültig.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SmartHosts

Der SmartHosts-Parameter gibt den Smarthost an, den der ausgehende Connector zum Weiterleiten von E-Mails verwendet. Gültige Werte sind:

  • FQDN eines Smarthostservers, eines MX-Eintrags (Mail Exchange) oder eines Adressdatensatzes (A): Beispiel: mail.contoso.com.
  • Einzelne IP-Adresse: Beispiel: 10.10.1.1.
  • CIDR-IP-Adressbereich (Classless InterDomain Routing): Beispiel: 192.168.0.1/25.

Sie können mehrere Werte angeben, die durch Kommas getrennt sind: "Value1","Value2",..."ValueN".

Dieser Parameter ist erforderlich, wenn Sie den Wert $false für den UseMxRecord-Parameter verwenden.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TestMode

Der TestMode-Parameter gibt an, ob Sie den Testmodus für den ausgehenden Connector aktivieren oder deaktivieren möchten. Gültige Werte sind:

  • $true: Der Testmodus ist aktiviert.
  • $false: Der Testmodus ist 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

-TlsDomain

Der Parameter TlsDomain gibt den Domänennamen an, anhand dessen der ausgehende Connector den FQDN des Zielzertifikats beim Herstellen einer über TLS gesicherten Verbindung überprüft. Ein gültiger Wert für diesen Parameter ist eine SMTP-Domäne.

Platzhalter werden unterstützt, um alle Unterdomänen einer Domäne anzugeben (z. B. *.contoso.com), aber Sie können das Platzhalterzeichen nicht in die Domäne einbetten (z. B. domäne.*.contoso.com).

Dieser Parameter ist nur dann aussagekräftig, wenn der TlsSettings-Wert DomainValidation ist.

Type:SmtpDomainWithSubdomains
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TlsSettings

Der Parameter TlsSettings gibt die TLS-Authentifizierungsebene für ausgehende TLS-Verbindungen an, die von diesem ausgehenden Connector hergestellt werden. Gültige Werte sind:

  • EncryptionOnly: TLS wird lediglich zum Verschlüsseln des Kommunikationskanals verwendet. Es wird keine Zertifikatsauthentifizierung durchgeführt.
  • CertificateValidation: TLS wird verwendet, um den Kanal zu verschlüsseln, und überprüfungen der Zertifikatkette und Sperrlisten werden ausgeführt.
  • DomainValidation: Zusätzlich zur Kanalverschlüsselung und Zertifikatüberprüfung überprüft der ausgehende Connector auch, ob der FQDN des Zielzertifikats mit der im TlsDomain-Parameter angegebenen Domäne übereinstimmt.
  • $null (leer): Dies ist der Standardwert.
Type:TlsAuthLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-UseMXRecord

Der Parameter UseMXRecord aktiviert oder deaktiviert das DNS-Routing für den Connector. Gültige Werte sind:

  • $true: Der Connector verwendet DNS-Routing (MX-Einträge in DNS), um E-Mails zu übermitteln. Dies ist der Standardwert.
  • $false: Der Connector übermittelt E-Mails an einen oder mehrere Smarthosts. Diese Einstellung erfordert mindestens einen Smarthost für den SmartHosts-Wert.
Type:Boolean
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.