Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-23

Командлет Test-SystemHealth используется для сбора данных о системе Microsoft Exchange и для анализа данных согласно рекомендациям.

Синтаксис


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

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

Параметры

Параметр	Обязательный	Тип	Описание
ADCredentials	Необязательный	System.Management.Automation.PSCredential	Параметр ADCredentials указывает учетные данные, используемые для получения доступа к службе каталогов Служба каталогов Active Directory. Значение по умолчанию — учетные данные текущего пользователя. Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential.
Analyze	Необязательный	System.Management.Automation.SwitchParameter	Параметр Analyze определяет, следует ли включить анализ собранных данных. При значении равном `$true` анализ включается. Значение по умолчанию: `$true`.
Collect	Необязательный	System.Management.Automation.SwitchParameter	Параметр Collect указывает, следует ли включить сбор данных. При значении равном `$true` сбор данных включается. Значение по умолчанию: `$true`.
ConfigurationData	Необязательный	System.Byte[]	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
ConfigurationFileLocation	Необязательный	Microsoft.Exchange.Data.LongPath	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.
Description	Необязательный	System.String	Параметр Description задает поясняющую метку для сканирования.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory.
DownloadConfigurationUpdates	Необязательный	System.Management.Automation.SwitchParameter	Параметр DownloadConfigurationUpdates включает проверку и загрузку новых версий файла конфигурации. Значение по умолчанию равно `$true`, что соответствует включению проверки и загрузки новых версий файла конфигурации.
ExchangeCredentials	Необязательный	System.Management.Automation.PSCredential	Параметр ExchangeCredentials указывает учетные данные, используемые для получения доступа к серверам, работающим под управлением Exchange. Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential.
Export	Необязательный	System.Management.Automation.SwitchParameter	Параметр Export активизирует удаление конфиденциальных данных из указанного выходного файла. При значении равном `$true` происходит удаление конфиденциальных данных. Значение по умолчанию: `$false`.
GenerateEvents	Необязательный	System.Management.Automation.SwitchParameter	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
GenerateSQMData	Необязательный	System.Management.Automation.SwitchParameter	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
MaxThreads	Необязательный	System.Int32	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
MergeFileLocation	Необязательный	Microsoft.Exchange.Data.LongPath	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
OutData	Необязательный	System.Management.Automation.SwitchParameter	Переключатель OutData указывает, следует ли отправлять выходные данные в виде байтового потока. Например, при выполнении `$temp=Test-SystemHealth -OutData` временная переменная `$temp` содержит байтовый поток выходных данных, который можно преобразовать в файл XML с помощью команды Set-Content. Образец кода см. в подразделе «ПРИМЕР 2».
OutFileLocation	Необязательный	Microsoft.Exchange.Data.LongPath	Параметр OutFileLocation идентифицирует имя и путь для создаваемого файла данных.
Roles	Необязательный	System.String[]	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
ScanType	Необязательный	System.String	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
ServerList	Необязательный	System.String[]	Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Timeout	Необязательный	Microsoft.Exchange.Data.EnhancedTimeSpan	Параметр Timeout задает количество секунд, в течение которых ожидается выполнение операции, прежде чем она будет блокирована по времени. Значение по умолчанию равно 300 секундам (5 минутам).
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

Подробное описание

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Проверка работоспособности системы» в разделе Разрешения инфраструктуры Exchange и командной консоли.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка	Описание

Исключения

Исключения	Описание

Примеры

ПРИМЕР 1

В этом примере выполняется сбор данных о системе Exchange.

	Скопировать код
Test-SystemHealth

ПРИМЕР 2

В этом примере во временной переменной $temp сохраняются выходные данные в виде байтового потока. Затем выполняется запись содержимого в файл SystemHealthOutData.xml с помощью командлета Set-Content.

	Скопировать код
$temp=Test-SystemHealth -OutData Set-Content -Value $temp.FileData -Path d:\temp\SystemHealthOutData.xml -Encoding Byte