通过

Get-ExchangeSettings

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

使用 Get-ExchangeSettings cmdlet 查看存储在 Active Directory 中的自定义 Exchange 设置对象。 使用 New-ExchangeSettings 创建 settings 对象，并使用 Set-ExchangeSettings cmdlet 定义实际设置。

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

语法

Default （默认值） 

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

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ConfigName 参数按指定的属性名称筛选结果。 指定的值在 EffectiveSetting 属性中可见。

可用值由 Exchange 设置对象的架构确定。

参数属性

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

参数集

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

-Database

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Database 参数按邮箱数据库筛选结果。 可以使用任何能够唯一标识此数据库的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • ExchangeLegacyDN
  • GUID

参数属性

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

参数集

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

-Diagnostic

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Diagnostic 开关指定是否在结果中返回非常详细的信息。 不必为此开关指定值。

详细信息显示在 DiagnosticInfo 属性中。

通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用此开关。

参数属性

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

参数集

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

-DiagnosticArgument

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DiagnosticArgument 参数修改使用 Diagnostic 开关返回的结果。 通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用 Diagnostic 开关和 DiagnosticArgument 参数。

参数属性

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

参数集

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

-DomainController

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

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

参数集

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

-Force

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

参数属性

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

参数集

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

-GenericScopeName

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

GenericScopeName 参数按范围筛选结果。 可用值由 Exchange 设置对象的架构确定。

参数属性

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

参数集

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

-GenericScopes

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

GenericScopes 参数按范围筛选结果。 可用值由 Exchange 设置对象的架构确定。 此参数使用语法 "key1=value1","key2=value2", "keyN=valueN。

参数属性

类型:

String[]

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

参数集

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

-GenericScopeValue

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

GenericScopeValue 参数按 GenericScopeName 参数指定的范围值筛选结果。 可用值由 Exchange 设置对象的架构确定。

参数属性

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

参数集

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

-Identity

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 参数指定 Exchange 设置对象的名称。 可以使用任何能够唯一标识该对象的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

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

参数集

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

-Organization

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

保留此参数以供 Microsoft 内部使用。

参数属性

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

参数集

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

-Process

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Process 参数按指定进程筛选结果。 可用值由 Exchange 设置对象的架构确定。

参数属性

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

参数集

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

-Server

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Server 参数按 Exchange 服务器筛选结果。 可以使用唯一标识该服务器的任何值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • ExchangeLegacyDN
  • GUID

参数属性

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

参数集

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

-User

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

User 参数按用户筛选结果。 可以通过用户 GUID 值 (标识用户，例如 87246450-1b19-4c81-93dc-1a4200eff66c) 。 若要查找用户的 GUID，请运行以下命令： Get-User <UserIdentity> | Format-List Name,GUID。

参数属性

类型:Guid
默认值: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。