Get-FederationInformation

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

使用 Get-FederationInformation cmdlet 从外部 Exchange 组织获取联合信息。

提示

有关为提高安全性和隐私而对 Get-FederationInformation cmdlet 所做的更改的信息,请参阅 Exchange Online 中 Get-FederationInformation Cmdlet 的重要更新

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

语法

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

说明

Get-FederationInformation cmdlet 从应启用联合的指定域检索联合信息。

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

示例

示例 1

Get-FederationInformation -DomainName contoso.com

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

参数

-BypassAdditionalDomainValidation

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DomainName

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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

类型:SmtpDomain
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Force

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrustedHostnames

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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

类型:MultiValuedProperty
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

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

输出

Output types

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