Get-ExchangeSettings
此 cmdlet 仅适用于本地 Exchange。
使用 Get-ExchangeSettings cmdlet 查看存储在 Active Directory 中的自定义 Exchange 设置对象。 使用 New-ExchangeSettings 创建 settings 对象，并使用 Set-ExchangeSettings cmdlet 定义实际设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-ExchangeSettings
[[-Identity] <ExchangeSettingsIdParameter>]
[-ConfigName <String>]
[-Database <DatabaseIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Force]
[-GenericScopeName <String>]
[-GenericScopes <String[]>]
[-GenericScopeValue <String>]
[-Organization <OrganizationIdParameter>]
[-Process <String>]
[-Server <ServerIdParameter>]
[-User <Guid>]
[<CommonParameters>] 说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ExchangeSettings此示例返回所有 Exchange 设置对象的摘要列表。
示例 2
Get-ExchangeSettings -Identity Audit | Format-List此示例返回所有 Exchange 设置对象的摘要列表。
参数
-ConfigName
ConfigName 参数按指定的属性名称筛选结果。 指定的值在 EffectiveSetting 属性中可见。
可用值由 Exchange 设置对象的架构确定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Database
Database 参数按邮箱数据库筛选结果。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- ExchangeLegacyDN
- GUID
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Diagnostic
Diagnostic 开关指定是否在结果中返回非常详细的信息。 不必为此开关指定值。
详细信息显示在 DiagnosticInfo 属性中。
通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用此开关。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-DiagnosticArgument
DiagnosticArgument 参数修改使用 Diagnostic 开关返回的结果。 通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用 Diagnostic 开关和 DiagnosticArgument 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Force
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopeName
GenericScopeName 参数按范围筛选结果。 可用值由 Exchange 设置对象的架构确定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopes
GenericScopes 参数按范围筛选结果。 可用值由 Exchange 设置对象的架构确定。 此参数使用语法 "key1=value1","key2=value2", "keyN=valueN。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-GenericScopeValue
GenericScopeValue 参数按 GenericScopeName 参数指定的范围值筛选结果。 可用值由 Exchange 设置对象的架构确定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定 Exchange 设置对象的名称。 可以使用任何能够唯一标识该对象的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
| Type: | ExchangeSettingsIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Organization
保留此参数以供 Microsoft 内部使用。
| Type: | OrganizationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Process
Process 参数按指定进程筛选结果。 可用值由 Exchange 设置对象的架构确定。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Server
Server 参数按 Exchange 服务器筛选结果。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- 可分辨名称 (DN)
- ExchangeLegacyDN
- GUID
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-User
User 参数按用户筛选结果。 可以通过用户 GUID 值 (标识用户，例如 87246450-1b19-4c81-93dc-1a4200eff66c) 。 若要查找用户的 GUID，请运行以下命令： Get-User <UserIdentity> | Format-List Name,GUID。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈