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