通过

Get-FederationInformation

模块:
Exchange PowerShell

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

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

提示

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

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

语法

Default （默认值） 

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 Server SE、Exchange Online、Exchange Online Protection

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainName

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

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

参数属性

类型:SmtpDomain
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Force

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TrustedHostnames

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

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

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

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

输出

Output types

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