Set-HybridConfiguration

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Set-HybridConfiguration, um die Hybridbereitstellung zwischen Ihrem lokalen Exchange-organization und Exchange Online in Microsoft 365 Enterprise zu ändern.

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

Syntax

Default (Standard)

Set-HybridConfiguration

    [-ClientAccessServers <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Domains <MultiValuedProperty>]
    [-EdgeTransportServers <MultiValuedProperty>]
    [-ExternalIPAddresses <MultiValuedProperty>]
    [-Features <MultiValuedProperty>]
    [-Name <String>]
    [-OnPremisesSmartHost <SmtpDomain>]
    [-ReceivingTransportServers <MultiValuedProperty>]
    [-SecureMailCertificateThumbprint <String>]
    [-SendingTransportServers <MultiValuedProperty>]
    [-ServiceInstance <Int32>]
    [-TlsCertificateName <SmtpX509Identifier>]
    [-TransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Mit dem Set-HybridConfiguration Cmdlet werden die Hybridkonfigurationsfeatures geändert, z. B. das Aktivieren von sicherem E-Mail, das Festlegen eines bestimmten Postfachservers für Hybridfunktionen oder das Aktivieren oder Deaktivieren der Frei/Gebucht-Freigabe zwischen lokalem Exchange und Exchange Online.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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-HybridConfiguration -SecureMailCertificateThumbprint AC00F35CBA8359953F4126E0984B5CCAFA2F4F17

In Exchange Server 2010 gibt dieses Beispiel an, dass die Hybridkonfiguration das Zertifikat mit dem Fingerabdruck AC00F35CBA8359953F4126E0984B5CCAFA2F4F17 als Zertifikat für Secure Mail-Nachrichten verwendet.

Beispiel 2

Set-HybridConfiguration -Features OnlineArchive,MailTips,OWARedirection,FreeBusy,MessageTracking

In diesem Beispiel werden die Features "Sicherer E-Mail" und "Zentraler Transport" für die Hybridbereitstellung deaktiviert, die Features "Exchange Online Archiv", "E-Mail-Infos", "Outlook im Web Umleitung", "Frei/Gebucht" und "Nachrichtenverfolgung" zwischen der lokalen Exchange- und der Exchange Online-Organisation jedoch aktiviert.

Beispiel 3

Set-HybridConfiguration -TlsCertificateName "<I>CN=A. Datum Corporation CA-3, OU=www.adatum.com, O=A.Datum Corp, C=US<S>CN=mail.contoso.com, O=Barbara Zighetti, L=Seattle, S=WA, C=US"

In diesem Beispiel wird festgelegt, dass die hybride Bereitstellung ein definiertes TLS-Zertifikat verwendet, welches von der Kombination der Attribute "Aussteller" und "Antragssteller" in dem von der Zertifizierungsstelle ausgegebenen X.509-Zertifikat referenziert wird.

Parameter

-ClientAccessServers

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Dieser Parameter ist nur in Exchange Server 2010 verfügbar.

Der Parameter ClientAccessServers gibt die Hub-Transport-Server in Exchange Server 2010 SP2 oder höher an, die für die Unterstützung von Hybridbereitstellungsfeatures konfiguriert sind. Sie müssen mindestens einen Clientzugriffsserver angeben, auf den über das Internet über die TCP-Ports 80 und 443 zugegriffen werden kann. Die Server sind so konfiguriert, dass sie die folgenden Features aktivieren:

  • Postfachreplikationsdienst (MRS)-Proxy: Aktivieren Sie die Konfiguration des MRS-Proxydiensts.
  • Virtuelle Verzeichnisse: Hosten Sie die Standardwebsites für Exchange-Webdienste (EWS), Offlineadressbücher und ActiveSync-Dienste.
  • Outlook Anywhere: aktiviert.

Sie können mehrere Server angeben, die durch Kommas getrennt werden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainController

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Parametereigenschaften

Typ:Fqdn
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Domains

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Domains gibt die Domänen-Namespaces an, die in der Hybridbereitstellung verwendet werden. Diese Domänen müssen entweder lokal in Exchange oder in Exchange Online als akzeptierte Domänen konfiguriert werden. Die Domänen werden für die Konfiguration der Organisationsbeziehungen und der Sende- und Empfangsconnectors verwendet, die von der Hybridkonfiguration genutzt werden.

Mehrere Domänen können durch Kommata getrennt angegeben werden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-EdgeTransportServers

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der EdgeTransportServers-Parameter gibt die Edge-Transport-Server an, die zur Unterstützung der Hybridbereitstellungsfunktionen konfiguriert sind. Der Edge-Transport-Server muss über das Internet an Port 25 extern zugänglich sein. Die akzeptierten Werte für den Parameter EdgeTransportServers sind entweder der vollständige Computername oder der Kurzname eines Edge-Transport-Servers (z. B. "edge.corp.contoso.com" oder "EDGE"). Trennen Sie die Servernamen durch ein Komma, wenn Sie mehrere Edge-Transport-Server angeben.

Wenn Sie den Parameter EdgeTransportServers konfigurieren, müssen Sie die Parameterwerte ReceivingTransportServers und SendingTransportServers auf $null festlegen.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ExternalIPAddresses

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter ExternalIPAddresses ist ein Legacyparameter, der die öffentlich zugängliche eingehende IP-Adresse von Microsoft Exchange Server 2010 Hub-Transport-Servern angibt.

Sie sollten diesen Parameter verwenden, um nur ältere Exchange 2010 Hub-Transport-Server-IP-Adresswerte zu ändern oder zu löschen. IPv6-Adressen werden nicht unterstützt.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Features

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Features gibt die Funktionen an, die für die Hybridkonfiguration aktiviert werden. Gültige Werte sind:

  • Onlinearchiv: Aktiviert das Exchange Online-Archiv für lokale Exchange- und Exchange Online-Benutzer.
  • FreeBusy: Aktiviert die Frei/Gebucht-Freigabe von Kalendern zwischen lokalen Exchange- und Exchange Online-Benutzern.
  • MailTips: Aktiviert E-Mail-Infos zwischen lokalen Exchange- und Exchange Online-Benutzern.
  • MessageTracking: Aktiviert die Nachrichtennachverfolgung zwischen dem lokalen Exchange und Exchange Online.
  • OWARedirection: Aktiviert die automatische Umleitung von Outlook im Web (früher bekannt als Outlook Web App oder OWA) zu lokalen Exchange oder Exchange Online, je nachdem, wo sich das Benutzerpostfach befindet.
  • SecureMail: Ermöglicht den sicheren Nachrichtentransport über Transport Layer Security (TLS) zwischen dem lokalen Exchange und Exchange Online.
  • Zentralisiert: Ermöglicht den lokalen Exchange-Servern die Abwicklung des gesamten Nachrichtentransports zwischen dem lokalen Exchange und Exchange Online, einschließlich der Nachrichtenübermittlung zum Internet für beide Organisationen. Wenn Sie diesen Wert nicht verwenden, sind jeweils lokal Exchange und Exchange Online für ihre eigene Internetnachrichtenübermittlung verantwortlich.
  • Fotos: Ermöglicht die gemeinsame Nutzung von Benutzerfotodaten zwischen dem lokalen Exchange und Exchange Online. Diese Funktion arbeitet mit dem Parameter PhotosEnabled in den Cmdlets zu OrganizationRelationship in einer Hybridbereitstellung zusammen. Wenn Sie diesen Wert verwenden, wird der Parameter PhotosEnabled automatisch auf $true gesetzt. Wenn Sie diesen Wert nicht verwenden, wird der Parameter "PhotosEnabled" automatisch auf $false gesetzt.

Es können mehrere Werte durch Kommata getrennt angegeben werden. Wenn Sie den Assistenten für die Hybridkonfiguration verwenden, sind alle Features standardmäßig aktiviert.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Dieser Parameter ist veraltet und wird nicht mehr verwendet.

Es kann nur ein HybridConfiguration-Objekt in einer Exchange-organization geben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnPremisesSmartHost

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter OnPremisesSmartHost gibt den FQDN des lokalen Exchange-Postfachservers an, der für den sicheren E-Mail-Transport zwischen dem lokalen Exchange und Exchange Online verwendet wird.

Parametereigenschaften

Typ:SmtpDomain
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ReceivingTransportServers

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter ReceivingTransportServers gibt die Postfachserver an, die in der Konfiguration des ausgehenden Connectors in Exchange Online definiert sind. Gültige Werte sind:

  • Der FQDN des Postfachservers (z. B. mbx.corp.contoso.com).
  • Der Hostname des Postfachservers (z. B. MBX).

Sie können mehrere Server angeben, die durch Kommas angegeben werden.

Die angegebenen Server empfangen sichere E-Mail-Nachrichten von Exchange Online an lokale Exchange in einer Hybridbereitstellung. Sie müssen mindestens einen öffentlich zugänglichen Postfachserver angeben, um sichere E-Mails zu aktivieren.

Der Wert dieses Parameters muss leer ($null) sein, wenn Sie den Parameter EdgeTransportServers verwenden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SecureMailCertificateThumbprint

Anwendbar: Exchange Server 2010

Der Parameter SecureMailCertificateThumbprint gibt den Fingerabdruck des X.509-Zertifikats an, das als Zertifikat für den sicheren Nachrichtentransport in Hybridbereitstellung verwendet werden soll. Dieses Zertifikat kann nicht selbstsigniert sein, muss von einer vertrauenswürdigen Zertifizierungsstelle (Certificate Authority, CA) abgerufen werden und muss auf allen Hub-Transport-Servern installiert werden, die im TransportServers-Parameter definiert sind.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SendingTransportServers

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter SendingTransportServers gibt die Postfachserver an, die in der Konfiguration des eingehenden Connectors in Exchange Online definiert sind. Gültige Werte sind:

  • Der FQDN des Postfachservers (z. B. mbx.corp.contoso.com).
  • Der Hostname des Postfachservers (z. B. MBX).

Sie können mehrere Server angeben, die durch Kommas angegeben werden.

Die angegebenen Server senden sichere E-Mail-Nachrichten von der lokalen Exchange an Exchange Online in einer Hybridbereitstellung. Sie müssen mindestens einen öffentlich zugänglichen Postfachserver angeben, um sichere E-Mails zu aktivieren.

Der Wert dieses Parameters muss leer ($null) sein, wenn Sie den Parameter EdgeTransportServers verwenden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServiceInstance

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Dieser Parameter ist nur in Office 365, das von 21Vianet in China betrieben wird, von Bedeutung.

Wenn Sie eine Hybridbereitstellung mit Office 365, das von 21Vianet in China betrieben wird, manuell konfigurieren möchten, legen Sie den Wert dieses Parameters auf 1 fest. Andernfalls ist der Standardwert 0.

Alle anderen Microsoft 365-Organisationen sollten den Hybridkonfigurations-Assistenten verwenden, um eine Hybridbereitstellung zu konfigurieren.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-TlsCertificateName

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der TlsCertificateName-Parameter gibt das X.509-Zertifikat an, das für die für TLS-Verschlüsselung verwendet werden soll. Die gültige Syntax für diesen Parameter lautet "<I>X.500Issuer<S>X.500Subject":

  • X.500Issuer: Der Wert im Feld "Aussteller" des Zertifikats.
  • X.500Subject: Der Wert im Feld "Antragsteller" des Zertifikats.

Sie können diese Werte finden, indem Sie das Get-ExchangeCertificate-Cmdlet ausführen.

Oder nachdem Sie Get-ExchangeCertificate ausgeführt haben, um den Fingerabdruckwert des Zertifikats zu suchen, verwenden Sie den Fingerabdruckwert im Befehl $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>, führen Sie den Befehl $TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)"aus, und verwenden Sie dann den Wert $TLSCertName für diesen Parameter.

Parametereigenschaften

Typ:SmtpX509Identifier
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-TransportServers

Anwendbar: Exchange Server 2010

Der TransportServers-Parameter gibt die Hub-Transport-Server in Exchange Server 2010 SP2 oder höher an, die für die Unterstützung von Hybridbereitstellungsfeatures konfiguriert sind.

Sie müssen mindestens einen Hub-Transport-Server angeben, auf den über das Internet für sichere E-Mails zwischen dem lokalen Exchange und Exchange Online zugegriffen werden kann.

Sie können mehrere Server angeben, die durch Kommas getrennt werden.

Parametereigenschaften

Typ:MultiValuedProperty
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.