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