Test-SystemHealth

 

适用于: Exchange Server 2010 SP2, Exchange Server 2010 SP3

上一次修改主题: 2015-03-09

使用 Test-SystemHealth cmdlet 可以收集有关 MicrosoftExchange 并使用最佳实践分析这些数据。


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

您必须先获得权限,然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数未包含在分配给您的权限中,则您无法访问这些参数。若要查看所需的权限,请参阅Exchange 和命令行管理程序基础结构权限主题中的“测试系统运行状况”条目。

 

参数 必需 类型 说明

ADCredentials

可选

System.Management.Automation.PSCredential

ADCredentials 参数指定用于访问 Active Directory 的凭据。默认值为当前用户的凭据。

此参数需要创建并传递凭据对象。此凭据对象是使用 Get-Credential cmdlet 创建的。有关详细信息,请参阅 Get-Credential

Analyze

可选

System.Management.Automation.SwitchParameter

Analyze 参数指定是否对所收集的数据启用分析。值为 $true 将启用分析。默认值为 $true

Collect

可选

System.Management.Automation.SwitchParameter

Collect 参数指定是否启用数据收集。值为 $true 将启用数据收集。默认值为 $true

ConfigurationData

可选

System.Byte[]

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

ConfigurationFileLocation

可选

Microsoft.Exchange.Data.LongPath

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

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 开关将导致命令暂停处理,并需要您在继续处理之前确认该命令将执行的操作。您无需使用 Confirm 开关指定值。

Description

可选

System.String

Description 参数指定针对扫描的说明性标签。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定从 Active Directory 中检索数据的域控制器的完全限定域名 (FQDN)。

DownloadConfigurationUpdates

可选

System.Management.Automation.SwitchParameter

DownloadConfigurationUpdates 参数检查并下载配置文件的较新版本。默认值为 $true,这将检查并下载配置文件的较新版本。

ExchangeCredentials

可选

System.Management.Automation.PSCredential

ExchangeCredentials 参数标识访问运行 Exchange 的服务器时所应用的凭据。

此参数需要创建并传递凭据对象。此凭据对象是使用 Get-Credential cmdlet 创建的。有关详细信息,请参阅 Get-Credential

Export

可选

System.Management.Automation.SwitchParameter

指定 Export 参数时将从指定的输出文件中删除敏感数据。值为 $true 时将删除数据。默认值为 $false

GenerateEvents

可选

System.Management.Automation.SwitchParameter

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

GenerateSQMData

可选

System.Management.Automation.SwitchParameter

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

MaxThreads

可选

System.Int32

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

MergeFileLocation

可选

Microsoft.Exchange.Data.LongPath

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

OutData

可选

System.Management.Automation.SwitchParameter

OutData 开关指定是否将输出数据作为字节流进行发送。例如,如果您运行 $temp=Test-SystemHealth -OutData,则 $temp 包含输出数据的字节流,并且您可以通过使用 Set-Content 命令将其转换回 xml。有关代码示例,请参阅本主题后面的“示例 2”。

OutFileLocation

可选

Microsoft.Exchange.Data.LongPath

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

Roles

可选

System.String[]

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

ScanType

可选

System.String

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

ServerList

可选

System.String[]

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

Timeout

可选

可选

Timeout 参数指定操作在多少秒后超时。默认值为 300 秒(5 分钟)。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 开关指示命令模拟对对象执行的操作。通过使用 WhatIf 开关,您可以查看要发生的更改,而无需应用这些更改中的任何更改。您无需使用 WhatIf 开关指定值。

若要查看此 cmdlet 接受的输入类型,请参阅 Cmdlet 输入和输出类型。如果 cmdlet 的输入类型字段为空,则 cmdlet 不接受输入数据。

若要查看此 cmdlet 接受的返回类型(也称为输出类型),请参阅 Cmdlet 输入和输出类型。如果输出类型字段为空,则 cmdlet 不返回数据。

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

Test-SystemHealth 

本示例将输出数据作为字节流保存到临时变量 $temp 中。然后,使用 Set-Content cmdlet 将这些内容写入到 SystemHealthOutData.xml 文件中。

$temp=Test-SystemHealth -OutData
Set-Content -Value $temp.FileData -Path d:\temp\SystemHealthOutData.xml -Encoding Byte
 
显示: