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 不返回任何数据。