New-InboundConnector

 

Gilt für:Exchange Online, Exchange Online Protection

Letztes Änderungsdatum des Themas:2016-03-31

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.

New-InboundConnector -Name <String> -SenderDomains <MultiValuedProperty> [-AssociatedAcceptedDomains <MultiValuedProperty>] [-CloudServicesMailEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectorSource <Default | Migrated | HybridWizard | AdminUI>] [-ConnectorType <OnPremises | Partner>] [-Enabled <$true | $false>] [-RequireTls <$true | $false>] [-RestrictDomainsToCertificate <$true | $false>] [-RestrictDomainsToIPAddresses <$true | $false>] [-SenderIPAddresses <MultiValuedProperty>] [-TlsSenderCertificateName <TlsCertificate>] [-TreatMessagesAsInternal <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

New-InboundConnector -Name "Contoso Inbound Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainstoIPAddresses $true

In diesem Beispiel wird der eingehende Connector "Contoso Inbound Secure Connector" erstellt, der für alle Nachrichten eine TLS-Übertragung erfordert.

New-InboundConnector -Name "Contoso Inbound Secure Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainstoIPAddresses $true -RequireTLS $true -TlsSenderCertificateName *.contoso.com

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. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Eingehende und ausgehende Connectors" im Thema Featureberechtigungen in Exchange Online.

 

Parameter Erforderlich Typ Beschreibung

Name

Erforderlich

System.String

Der Parameter Name gibt einen beschreibenden Namen für den Connector an.

SenderDomains

Erforderlich

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter SenderDomains gibt die Remotedomänen an, von denen dieser Connector Nachrichten akzeptiert, wodurch der Bereich eingeschränkt wird. Sie können ein Platzhalterzeichen verwenden, um alle Unterdomänen einer bestimmten Domäne anzugeben (siehe das folgende Beispiel): *.contoso.com. Es ist jedoch nicht möglich, ein Platzhalterzeichen einzubetten, wie im folgenden Beispiel gezeigt: domain.*.contoso.com. Mehrere Domänen können durch Komma getrennt angegeben werden.

AssociatedAcceptedDomains

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter AssociatedAcceptedDomains gibt die akzeptierten Domänen an, für die der Connector gilt, wodurch der Bereich eingeschränkt wird. Sie können den Connector z. B. auf eine bestimmte akzeptierte Domäne in Ihrer Organisation wie etwa "contoso.com" anwenden.

CloudServicesMailEnabled

Optional

System.Boolean

Hinweis:   Sie sollten diesen Parameter nur dann verwenden, wenn Sie durch den Microsoft-Kundendienst und -Support oder durch die spezifische Produktdokumentation dazu aufgefordert werden. Verwenden Sie stattdessen den Assistenten für hybride Konfiguration, 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 Hybridnachrichtenfluss zwischen einer lokalen Exchange-Umgebung und Microsoft Office 365 verwendet werden soll. Insbesondere steuert dieser Parameter, wie bestimmte interne X-MS-Exchange-Organization-*-Nachrichtenheader in Nachrichten verarbeitet werden, die zwischen akzeptierten Domänen in den lokalen und Cloudorganisationen gesendet wurden. Diese Header werden im Allgemeinen als standortübergreifende Header bezeichnet.

Gültige Werte sind:

  • $true. Der Connector wird für den Nachrichtenfluss in Hybridorganisationen verwendet. Daher werden standortübergreifende Header in Nachrichten beibehalten oder höher gestuft, die durch den Connector geleitet werden. Hierbei handelt es sich um den Standardwert für Connectors, die durch den Assistenten für hybride Konfiguration erstellt werden.

    Für ausgehende Nachrichten beibehalten. Bestimmte X-MS-Exchange-Organization-*-Header in den ausgehenden Nachrichten, die von einer Seite der Hybridorganisation zu anderen gesendet werden, werden zu X-MS-Exchange-CrossPremises-*-Headern umgewandelt und daher in Nachrichten beibehalten.

    Für eingehende Nachrichten heraufgestuft. 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-*-Header heraufgestuft. Diese heraufgestuften Header ersetzen die Instanzen derselben X-MS-Exchange-Organization-*-Header, die bereits in Nachrichten vorhanden sind.

  • $false. Der Connector wird für den Nachrichtenfluss in Hybridorganisationen nicht verwendet. Daher werden standortübergreifende Header aus Nachrichten entfernt, die durch den Connector geleitet werden.

Comment

Optional

System.String

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

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Switch Confirm gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie dieser Switch sich auf das Cmdlet auswirkt, hängt davon ab, ob für den Switch vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pausefunktion, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie mithilfe der exakt folgenden Syntax die Bestätigungsaufforderung überspringen: -Confirm:$false.

  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pausefunktion. Bei diesen Cmdlets führt das Angeben des Confirm-Switches ohne einen Wert eine Pausefunktion ein, wodurch Sie gezwungen werden, den Befehl zu bestätigen, bevor Sie fortfahren.

ConnectorSource

Optional

Microsoft.Exchange.Data.TenantConnectorSource

Der Parameter ConnectorSource gibt an, wie der Connector erstellt wird. Gültige Eingabewerte für diesen Parameter sind:

  • Default   Der Connector wird manuell erstellt.

  • HybridWizard   Der Connector wird automatisch vom Assistenten für Hybridkonfigurationen erstellt.

  • Migrated   Der Connector wurde ursprünglich in Microsoft Forefront Online Protection for Exchange erstellt.

Der Standardwert für Connectors, die Sie selbst erstellen, ist Default. Es ist nicht empfehlenswert, diesen Wert zu ändern.

ConnectorType

Optional

Microsoft.Exchange.Data.TenantConnectorType

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.

Enabled

Optional

System.Boolean

Der Parameter Enabled aktiviert oder deaktiviert den Connector. Die gültige Eingabe für diesen Parameter ist $true oder $false. Der Standardwert lautet $true.

RequireTls

Optional

System.Boolean

Der Parameter RequireTLS gibt an, dass alle Nachrichten, die von diesem Connector empfangen werden, TLS-Übermittlung erfordern. Gültige Werte für diesen Parameter sind $true und $false. Der Standardwert lautet $false.

RestrictDomainsToCertificate

Optional

System.Boolean

Wenn der Parameter RestrictDomainsToCertificate auf $true festgelegt ist, lehnt der Connector Nachrichten ab, die von einem im Parameter SenderDomains nicht angegebenen Namespace stammen.

RestrictDomainsToIPAddresses

Optional

System.Boolean

Wenn der Parameter RestrictDomainsToIPAddresses auf $true festgelegt ist, werden Nachrichten von den im Parameter SenderDomains angegebenen Domänen automatisch abgelehnt, falls die Nachrichten von einer IP-Adresse stammen, die nicht im Parameter SenderIPAddresses angegeben ist.

Die gültige Eingabe für diesen Parameter ist $true oder $false. Der Standardwert lautet $false.

SenderIPAddresses

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter SenderIPAddresses gibt die IP-Remoteadressen an, von denen dieser Connector Nachrichten akzeptiert. Sie geben die IP-Adressen mit der folgenden Syntax ein:

  • Einzelne IP-Adresse   Zum Beispiel: 192.168.1.1

  • CIDR-IP    Sie können das klassenlose, domänenübergreifende Routing (Classless InterDomain Routing, CIDR) verwenden, z. B. 192.168.0.1/25.

Mehrere IP-Adressen können durch Komma getrennt angegeben werden.

TlsSenderCertificateName

Optional

Microsoft.Exchange.Data.TlsCertificate

Der TlsSenderCertificateName-Parameter gibt das Zertifikat an, dass von der Absenderdomäne verwendet wird, wenn der RequireTls-Parameter auf $true festgelegt wird. Die gültige Eingabe für den Parameter TlsSenderCertificateName ist eine SMTP-Domäne. Sie können ein Platzhalterzeichen verwenden, um alle Unterdomänen einer bestimmten Domäne anzugeben (siehe das folgende Beispiel): *.contoso.com.

Es ist nicht möglich, ein Platzhalterzeichen einzubetten, wie im folgenden Beispiel gezeigt wird: domain.*.contoso.com.

TreatMessagesAsInternal

Optional

System.Boolean

PARAMETERWERT: $true | $false

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Switch 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.

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.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: