Get-FederationInformation

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Get-FederationInformation, um Verbundinformationen, einschließlich Verbunddomänennamen und Ziel-URLs, aus einer externen Exchange-Organisation abzurufen.

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

Syntax

Get-FederationInformation
   -DomainName <SmtpDomain>
   [-BypassAdditionalDomainValidation]
   [-Force]
   [-TrustedHostnames <MultiValuedProperty>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-FederationInformation ruft Verbundinformationen aus der angegebenen Domäne ab. Die Ergebnisse des Cmdlets können an das Cmdlet New-OrganizationRelationship weitergeleitet werden, um eine Organisationsbeziehung mit der abgefragten Exchange-Organisation herzustellen.

Die angegebene Domäne muss für den Verbund aktiviert sein.

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

Get-FederationInformation -DomainName contoso.com

In diesem Beispiel werden Verbundinformationen aus der Domäne "contoso.com" abgerufen.

Parameter

-BypassAdditionalDomainValidation

Der Schalter BypassAdditionalDomainValidation gibt an, dass der Befehl die Überprüfung von Domänen aus der externen Exchange-Organisation überspringt. Sie müssen bei dieser Option keinen Wert angeben.

Es wird empfohlen, diesen Switch nur zum Abrufen von Verbundinformationen in einer Hybridbereitstellung zwischen lokalen und Exchange Online Organisationen zu verwenden. Verwenden Sie diesen Switch nicht, um Verbundinformationen für lokale Exchange-Organisationen in einer organisationsübergreifenden Anordnung abzurufen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainName

Der Parameter DomainName gibt den Namen der Domäne an, für die Verbundinformationen abgerufen werden sollen.

Type:	SmtpDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Eine Bestätigungsaufforderung warnt Sie, wenn der Hostname im AutoErmittlungsendpunkt der Domäne nicht mit dem SSL-Zertifikat (Secure Sockets Layer) des Endpunkts übereinstimmt und der Hostname nicht im TrustedHostnames-Parameter angegeben ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TrustedHostnames

Der Parameter TrustedHostnames gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) der Verbundendpunkte an. Bei Verbundendpunkten handelt es sich um Clientzugriffsserver in einer Organisation, die für den Verbund aktiviert ist. Bei expliziter Angabe des Parameters TrustedHostnames kann das Cmdlet die Aufforderung umgehen, wenn das vom Endpunkt vorgelegte Zertifikat nicht mit dem im Parameter DomainName angegebenen Domänennamen übereinstimmt.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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.