Get-FederationInformation

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Get-FederationInformation cmdlet 从外部 Exchange 组织获取联合信息，包括联合域名和目标 URL。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

Get-FederationInformation cmdlet 从指定的域检索联合信息。 cmdlet 的结果可以通过管道传输到 New-OrganizationRelationship cmdlet，以便与被查询的 Exchange 组织建立组织关系。

指定的域应该启用联合。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-FederationInformation -DomainName contoso.com

本示例从域 Contoso.com 中获得联合信息。

参数

-BypassAdditionalDomainValidation

BypassAdditionalDomainValidation 开关指定命令跳过外部 Exchange 组织的域验证。不必为此开关指定值。

建议仅使用此开关在本地和Exchange Online组织之间的混合部署中检索联合信息。请勿使用此开关检索跨组织安排中的本地 Exchange 组织的联合信息。

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

DomainName 参数指定要检索联合信息的域名。

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

强制开关隐藏警告或确认消息。不必为此开关指定值。

如果域的自动发现终结点中的主机名与终结点提供的安全套接字层 (SSL) 证书不匹配，并且主机名未在 TrustedHostnames 参数中指定，则系统会发出确认提示。

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

TrustedHostnames 参数指定联合终结点的完全限定的域名 (FQDN)。联合身份验证终结点是组织中已启用联合身份验证的邮箱服务器上的客户端访问（前端）服务。如果终结点提供的证书与 DomainName 参数中指定的域名不匹配，则显式指定 TrustedHostnames 参数将允许 cmdlet 绕过提示。

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

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。