Test-SystemHealth

此 cmdlet 仅在 2010 Exchange Server可用。

使用 Test-SystemHealth cmdlet 收集有关 Microsoft Exchange 系统的数据,并根据最佳做法分析数据。

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

语法

Test-SystemHealth
    [-ADCredentials <PSCredential>]
    [-Analyze]
    [-Collect]
    [-ConfigurationData <Byte[]>]
    [-ConfigurationFileLocation <LongPath>]
    [-Confirm]
    [-Description <String>]
    [-DomainController <Fqdn>]
    [-DownloadConfigurationUpdates]
    [-ExchangeCredentials <PSCredential>]
    [-Export]
    [-GenerateEvents]
    [-GenerateSQMData]
    [-MaxThreads <Int32>]
    [-MergeFileLocation <LongPath>]
    [-OutData]
    [-OutFileLocation <LongPath>]
    [-Roles <String[]>]
    [-ScanType <String>]
    [-ServerList <String[]>]
    [-Timeout <EnhancedTimeSpan>]
    [-WhatIf]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Test-SystemHealth

此示例收集有关 Exchange 系统的数据。

示例 2

$SysHealth = Test-SystemHealth -OutData

[System.IO.File]::WriteAllBytes('D:\temp\SystemHealthOutData.xml', $SysHealth.FileData)

此示例将输出数据作为字节流保存到名为 $SysHealth 的变量。 然后,内容将写入 D:\temp 文件夹中的 SystemHealthOutData.xml 文件。

参数

-ADCredentials

ADCredentials 参数指定用于访问 Active Directory 的用户名和密码。 通常情况下,您可以在脚本中或在需要提供具有所需权限的不同凭据时使用此参数。

此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示,请使用值 (Get-Credential)。 或者,在运行此命令之前,请将凭据存储在变量(例如,$cred = Get-Credential)中,然后将变量名称 ($cred) 用作此参数。 有关详细信息,请参阅 Get-Credential

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Analyze

“分析”开关可对收集的数据进行分析。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Collect

“收集”开关启用数据收集。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ConfigurationData

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

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ConfigurationFileLocation

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

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Description

Description 参数指定扫描的描述性标签。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-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 2010

-DownloadConfigurationUpdates

DownloadConfigurationUpdates 开关检查并下载配置文件的较新版本。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ExchangeCredentials

ExchangeCredentials 参数指定用于访问 Exchange 服务器的用户名和密码。 通常情况下,您可以在脚本中或在需要提供具有所需权限的不同凭据时使用此参数。

此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示,请使用值 (Get-Credential)。 或者,在运行此命令之前,请将凭据存储在变量(例如,$cred = Get-Credential)中,然后将变量名称 ($cred) 用作此参数。 有关详细信息,请参阅 Get-Credential

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Export

“导出”开关会导致从指定的输出文件中删除敏感数据。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GenerateEvents

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GenerateSQMData

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MaxThreads

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MergeFileLocation

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

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OutData

OutData 开关指定是否将输出数据作为字节流发送。 不必为此开关指定值。

例如,如果运行命令: $temp = Test-SystemHealth -OutData$temp 则包含输出数据的字节流,并且可以使用 Set-Content 命令将其掩码回 xml。 有关代码示例,请参阅本主题中的“示例 2”。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OutFileLocation

OutFileLocation 参数标识要生成的数据文件的名称和路径。

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Roles

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ScanType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ServerList

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Timeout

Timeout 参数指定操作超时之前的秒数。默认值为 300 秒 (5 分钟) 。

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。