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.comIn 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.