Set-SPDiagnosticConfig

Задает параметры диагностики для фермы.

Синтаксис

Default (по умолчанию)

Set-SPDiagnosticConfig
    [-AllowLegacyTraceProviders]
    [-AppAnalyticsAutomaticUploadEnabled]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CustomerExperienceImprovementProgramEnabled]
    [-DaysToKeepLogs <Int32>]
    [-DownloadErrorReportingUpdatesEnabled]
    [-ErrorReportingAutomaticUploadEnabled]
    [-ErrorReportingEnabled]
    [-EventLogFloodProtectionEnabled]
    [-EventLogFloodProtectionNotifyInterval <Int32>]
    [-EventLogFloodProtectionQuietPeriod <Int32>]
    [-EventLogFloodProtectionThreshold <Int32>]
    [-EventLogFloodProtectionTriggerPeriod <Int32>]
    [-InputObject <PSObject>]
    [-LogCutInterval <Int32>]
    [-LogDiskSpaceUsageGB <Int32>]
    [-LogLocation <String>]
    [-LogMaxDiskSpaceUsageEnabled]
    [-ScriptErrorReportingDelay <Int32>]
    [-ScriptErrorReportingEnabled]
    [-ScriptErrorReportingRequireAuth]
    [<CommonParameters>]

Описание

Set-SPDiagnosticConfig Используйте командлет , чтобы задать параметры конфигурации диагностики во всей ферме.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

ПРИМЕР 1

Set-SPDiagnosticConfig -ErrorReportingEnabled -DownloadErrorReportingUpdatesEnabled:$false -DaysToKeepLog 60

В этом примере включается ErrorReporting, отключается DownloadErrorReportingUpdatesEnable и устанавливается значение DaysToKeepLog в значение 60.

ПРИМЕР 2

$config = Get-SPDiagnosticConfig
$config.CustomerExperienceImprovementProgramEnabled = $false
$config.LogCutInterval = 60
$config | Set-SPDiagnosticConfig

В этом примере программа улучшения качества программного обеспечения отключается, а параметру LogCutInterval присваивается значение 60.

Параметры

-AllowLegacyTraceProviders

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, что поставщики трассировки, созданные для предыдущих версий продуктов и технологий SharePoint, могут записывать данные в сеанс трассировки для продуктов SharePoint.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AppAnalyticsAutomaticUploadEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AssignmentCollection

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

При использовании параметра Global все объекты содержатся в глобальном хранилище. Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CustomerExperienceImprovementProgramEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Включает или отключает участие в программе улучшения качества программного обеспечения (CEIP).

Программа CEIP разработана для улучшения качества, надежности и производительности продуктов и технологий Майкрософт. С вашего разрешения анонимная информация о сервере отправляется в корпорацию Майкрософт для улучшения продуктов SharePoint.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DaysToKeepLogs

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает время хранения файлов журнала трассировки (в днях). Типом должно быть число от 1 до 366. Значение по умолчанию: 14 дней.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DownloadErrorReportingUpdatesEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, необходимо ли загружать файл отчета об ошибках удаленного управления.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ErrorReportingAutomaticUploadEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, необходимо ли автоматически отправлять отчеты об ошибках в корпорацию Майкрософт.

Отчеты об ошибках содержат сведения о состоянии сервера на момент возникновения проблемы, версию операционной системы и сведения об аппаратных средствах компьютера, а также цифровой идентификатор продукта, который может быть использован для определения используемой лицензии. Кроме того, передается IP-адрес компьютера, так как для отправки отчета об ошибках необходимо подключиться к сетевой службе, но он используется только для сбора статистических данных.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ErrorReportingEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Включает или отключает сбор отчетов об ошибках.

Отчеты об ошибках создаются, когда в системе возникают неполадки с аппаратным или программным обеспечением. Корпорация Майкрософт и ее партнеры используют эти отчеты для повышения надежности программного обеспечения. Отчеты об ошибках содержат сведения о состоянии сервера при возникновении проблемы, версию используемой операционной системы и информацию об оборудовании, а также цифровой идентификатор продукта, используемый для определения лицензии. Кроме того, передается IP-адрес компьютера, поскольку для отправки отчета необходимо подключиться к сетевой службе, но он используется только для сбора статистических данных.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EventLogFloodProtectionEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Включает или отключает функцию защиты журнала событий от переполнения.

Если в журнал событий записаны несколько схожих событий, некоторые повторяющиеся сообщения скрываются. Через определенный период времени записывается итоговое сообщение со сведениями о количестве скрытых сообщений.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EventLogFloodProtectionNotifyInterval

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает частоту (в минутах) записи итогового сообщения со сведениями о количестве сообщений, скрытых для защиты от переполнения.

Допустимым является диапазон от 1 до 1440. Значение по умолчанию: 5.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EventLogFloodProtectionQuietPeriod

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает временной интервал в минутах, определяющий время отсутствия событий, после которого может быть отключена защита от переполнения.

Допустимым является диапазон от 1 до 1440. Значение по умолчанию: 2.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EventLogFloodProtectionThreshold

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает количество событий, которые могут быть сформированы в указанный интервал времени. При большем количестве событий журнал событий будет переполняться.

Допустимым является диапазон целых чисел от 1 до 100. Значение по умолчанию равно 5.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EventLogFloodProtectionTriggerPeriod

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает временной интервал в минутах, в течение которого необходимо вести наблюдение за событиями, которые могут привести к переполнению журнала.

Допустимым является диапазон от 1 до 1440. Значение по умолчанию: 2.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InputObject

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Используйте результат командлета Get-SPDiagnosticConfig , внесите изменения, а затем переведите объект в Set-SPDiagnosticConfig командлет для обновления базы данных контента.

Свойства параметра

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LogCutInterval

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает количество минут между переключениями файлов журнала.

Значением должно быть целое число от 0 до 1440.

Значение по умолчанию — 30 дней.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-LogDiskSpaceUsageGB

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает максимальный объем места в гигабайтах для хранения файлов журналов трассировки.

Значение по умолчанию равно 1000, и оно применяется только в том случае, если командлету LogMaxDiskSpaceusageEnabled присвоено значение True.

Типом должно быть допустимое число от 1 до 1000.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-LogLocation

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает путь к файлам журналов.

Типом должен быть допустимый путь в формате C:\Logs.

Значение по умолчанию: %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Logs.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-LogMaxDiskSpaceUsageEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, необходимо ли ограничить пространство, используемое для хранения файлов журналов трассировки.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию: $False.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ScriptErrorReportingDelay

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает интервал в минутах между отчетами об ошибках скрипта.

Типом должно быть целое число от 0 до 1440. Значение указывается в минутах.

Значение по умолчанию — 30 дней.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ScriptErrorReportingEnabled

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Включает или отключает создание отчетов об ошибках клиентских скриптов.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ScriptErrorReportingRequireAuth

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, необходима ли проверка подлинности для отчетов об ошибках скриптов.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию — $True.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.