Get-AuthenticationPolicy
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-AuthenticationPolicy cmdlet 查看组织中的身份验证策略。 有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Get-AuthenticationPolicy
[[-Identity] <AuthPolicyIdParameter>]
[-AllowLegacyExchangeTokens]
[-TenantId <String>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-AuthenticationPolicy | Format-Table -Auto Name
此示例返回所有身份验证策略的摘要列表。
示例 2
Get-AuthenticationPolicy -Identity "Engineering Group"
此示例返回名为“工程组”的身份验证策略的详细信息。
示例 3
Get-AuthenticationPolicy -AllowLegacyExchangeTokens
在 Exchange Online 中,此示例指定组织中是否允许 Outlook 外接程序的旧 Exchange 令牌。
参数
-AllowLegacyExchangeTokens
适用:Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中可用。
AllowLegacyExchangeTokens 开关指定是否允许组织中 Outlook 加载项使用旧 Exchange 令牌。 不必为此开关指定值。
旧版 Exchange 令牌包括 Exchange 用户标识和回调令牌。
重要说明:
- 从 2025 年 8 月到 2025 年 9 月,所有组织都将关闭旧版Exchange Online令牌。 关闭后,不能使用 Set-AuthenticationPolicy cmdlet 上的 AllowLegacyExchangeTokens 开关来打开这些令牌。 运行 命令
Get-AuthenticationPolicy -AllowLegacyExchangeTokens时,会收到警告“旧Exchange Online令牌已禁用”。 可以联系Microsoft 支持部门请求例外。 有关详细信息,请参阅 嵌套应用身份验证和 Outlook 旧令牌弃用常见问题解答。 - 如果在组织中未使用 Set-AuthenticationPolicy cmdlet 上的 AllowLegacyExchangeTokens 或 BlockLegacyExchangeTokens 参数显式允许或阻止令牌,则 AllowLegacyExchangeTokens 开关返回
Not Set。 有关详细信息,请参阅获取旧版Exchange Online令牌和使用它们的加载项的状态。
参数属性
| 类型: | SwitchParameter |
| 默认值: | True |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection
Identity 参数指定要查看的身份验证策略。 可以使用任何能够唯一标识该策略的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
参数属性
| 类型: | AuthPolicyIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-TenantId
适用:Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中可用。
{{ Fill TenantId Description }}
参数属性
| 类型: | String |
| 默认值: | 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。