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 |