Test-SystemHealth

Этот командлет доступен только в Exchange Server 2010 г.

Используйте командлет Test-SystemHealth для сбора данных о системе Exchange Майкрософт и анализа данных в соответствии с рекомендациями.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье 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. Затем содержимое записывается в файл SystemHealthOutData.xml в папке D:\temp.

Параметры

-ADCredentials

Параметр ADCredentials указывает имя пользователя и пароль, используемые для доступа к Active Directory. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (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

Параметр Collect включает сбор данных. Указывать значение для этого параметра необязательно.

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

-ConfigurationData

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-ConfigurationFileLocation

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя 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 указывает контроллер домена, который используется этим командлетом для чтения или записи данных в 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. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-GenerateSQMData

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-MaxThreads

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-MergeFileLocation

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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 содержит поток байтов выходных данных, и вы можете скрыть его обратно в xml с помощью команды Set-Content. Пример кода см. в разделе Пример 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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-ScanType

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-ServerList

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.