Set-CsClsConfiguration

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Изменяет существующую коллекцию параметров конфигурации централизованного ведения журнала. Централизованное ведение журнала предоставляет администраторам возможность одновременного включения или выключения трассировки на нескольких компьютерах. Данный командлет впервые появился в Lync Server 2013.

Set-CsClsConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Set-CsClsConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-CacheFileLocalFolders <String>] [-CacheFileLocalMaxDiskUsage <UInt32>] [-CacheFileLocalRetentionPeriod <UInt32>] [-CacheFileNetworkFolder <String>] [-ComponentThrottleLimit <UInt32>] [-ComponentThrottleSample <UInt32>] [-Confirm [<SwitchParameter>]] [-EtlFileFolder <String>] [-EtlFileRolloverMinutes <UInt32>] [-EtlFileRolloverSizeMB <UInt32>] [-Force <SwitchParameter>] [-MinimumClsAgentServiceVersion <UInt32>] [-NetworkUsagePacketSize <UInt32>] [-NetworkUsageThreshold <UInt32>] [-Regions <PSListModifier>] [-Scenarios <PSListModifier>] [-SearchTerms <PSListModifier>] [-SecurityGroups <PSListModifier>] [-TmfFileSearchPath <String>] [-Version <String>] [-WhatIf [<SwitchParameter>]]

В Примере 1 глобальную коллекцию параметров конфигурации централизованного ведения журнала изменяют, чтобы установить максимальный размер ETL-файла, равный 40 МБ.

Set-CsClsConfiguration -Identity "global" -EtlRolloverFileSizeMB 40

Команда, показанная в примере 2, изменяет максимальный размер файла ETL для всех параметров конфигурации централизованного ведения журналов, которые используются в организации. Для этого команда сначала вызывает командлет Get-CsClsConfiguration , который возвращает коллекцию всех параметров централизованного ведения журналов. Эта коллекция затем передается в командлет Set-CsClsConfiguration , который изменяет значение свойства EtlRolloverFileSizeMB для каждого элемента в коллекции на 40 МБ.

Get-CsClsConfiguration | Set-CsClsConfiguration -EtlRolloverFileSizeMB 40

Служба централизованного ведения журналов, которая заменяет средства OCSLogger и OCSTracer, используемые в Microsoft Lync Server 2010, позволяет администраторам управлять ведением журналов и трассировкой для всех компьютеров и пулов Skype для бизнеса Server 2015. Эта служба позволяет администраторам запускать, останавливать и настраивать ведение журналов как для одного пула и компьютера, так и для нескольких пулов и компьютеров с помощью одной команды. Например, с помощью одной команды можно включить ведение журнала службы адресной книги на всех серверах адресных книг. Централизованное ведение журналов отличается от средств OCSLogger и OCSTracer, которые требовали индивидуального управления (включая запуск и остановку) на каждом сервере. Кроме того, служба централизованного ведения журналов также позволяет администраторам выполнять поиск журналов трассировки с помощью командной строки Windows PowerShell и командлета Search-CsClsLogging.

Централизованное ведение журналов строится вокруг ряда предопределенных сценариев, предлагающих более адресный подход к ведению журналов, чем в предыдущих версиях Skype для бизнеса Server 2015. В этих сценариях предопределяются компоненты сервера и ведение журналов; в результате администратор, включая сценарий RGS, может быть уверен, что в журнал будут заноситься только сведения, относящиеся к службе "Группа ответа", и не будут включаться сведения, относящиеся к другим службам, например, к службе поставщика аудиоконференций.

Также можно определить пользовательские сценарии с помощью командлета New-CsClsScenario.

Централизованное ведение журналов управляется с помощью коллекций параметров службы централизованного ведения журналов. При установке Skype для бизнеса Server 2015 вы устанавливаете глобальный набор этих параметров конфигурации. Кроме того, администраторы могут добавить пользовательские коллекции параметров на уровне сайта. Администраторы могут использовать командлет Set-CsClsConfiguration для изменения любых этих параметров.

Панель Панель управления Skype для бизнеса Server: функции, выполняемые командлетом Set-CsClsConfiguration , недоступны в панели Панель управления Skype для бизнеса Server.

 

Параметр Применение Тип Описание

CacheFileLocalFolders

Необязательный

System.String

Один или несколько полных путей к локальным папкам для хранения файлов кэша. По умолчанию используется значение %TEMP%\Tracing. При указании нескольких путей разделяйте их точкой с запятой.

CacheFileLocalMaxDiskUsage

Необязательный

System.UInt32

Максимальное количество дискового пространства (в процентах), которое можно использовать для файлов кэша. По умолчанию значение 80.

CacheFileLocalRetentionPeriod

Необязательный

System.UInt32

Максимальное число дней, в течение которых файлы кэша хранятся локально. Значение по умолчанию — 14.

CacheFileNetworkFolder

Необязательный

System.String

Полный UNC-путь к папке сетевого кэша. Значения по умолчанию нет.

ComponentThrottleLimit

Необязательный

System.UInt32

Максимальная скорость, с которой компоненту разрешено создавать записи трассировки до начала регулирования трассировки. Значение по умолчанию — 5000 вызовов трассировки в секунду.

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

ComponentThrottleSample

Необязательный

System.UInt32

Максимальное количество превышений ComponentThrottleLimit в течение одной минуты. По умолчанию используется значение "3".

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

EtlFileFolder

Необязательный

System.String

Полный путь к папке, в которой будут храниться файлы трассировки журнала событий. Значение по умолчанию — %TEMP%\Tracing. Обратите внимание на то, что %TEMP% оценивается по содержимому службы CLS, поэтому фактически расширяется до %WINDIR%\ServiceProfiles\NetworkService\AppData\Local

EtlFileRolloverMinutes

Необязательный

System.UInt32

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

EtlFileRolloverSizeMB

Необязательный

System.UInt32

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

Force

Необязательный

System.Management.Automation.SwitchParameter

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

Identity

Необязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор параметров конфигурации централизованного ведения журнала. Для ссылки на глобальные параметры используйте следующий синтаксис:

-Identity global

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

-Identity site:Redmond

При задании удостоверения нельзя использовать подстановочные знаки.

Instance

Необязательный

System.Management.Automation.PSObject

Позволяет передать ссылку на объект вместо задания значений отдельных параметров.

MinimumClsAgentServiceVersion

Необязательный

System.UInt32

Указывает минимальную версию агента службы централизованного ведения журналов, которая должна использоваться при записи данных в журнал. Любые компьютеры с версией агента ниже минимальной будут исключены из операций ведения журнала. По умолчанию используется значение 6, обозначающее Skype для бизнеса Server 2015. Этот параметр предназначен для использования с Skype для бизнеса Online.

NetworkUsagePacketSize

Необязательный

System.UInt32

Размер пакетов (в килобайтах) для передачи результатов поиска агентов и копирования файлов кэша через сеть. Значение по умолчанию — 64 КБ.

NetworkUsageThreshold

Необязательный

System.UInt32

Порог использования пропускной способности (в МБ/с) для передачи результатов поиска агентов и копирования файлов кэша через сеть. Значение по умолчанию — 10.

Regions

Необязательный

System.Management.Automation.PSListModifier

Коллекция регионов, определенных для параметров конфигурации централизованного ведения журнала. Регионы определяются командлетом New-CsClsRegion.

Этот параметр предназначен для использования с Skype для бизнеса Online.

Scenarios

Необязательный

System.Management.Automation.PSListModifier

Коллекция компонентов и ситуаций, которые можно отслеживать с помощью централизованного ведения журналов. Сценарии управляются с помощью командлетов CsClsScenario .

SearchTerms

Необязательный

System.Management.Automation.PSListModifier

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

SecurityGroups

Необязательный

System.Management.Automation.PSListModifier

Группы безопасности, которым разрешен доступ к файлам журнала.

Этот параметр предназначен для использования с Skype для бизнеса Online.

TmfFileSearchPath

Необязательный

System.String

Путь поиска для файлов TMF (формата сообщения трассировки). Файлы TMF преобразуют бинарные данные в удобно читаемый формат.

Version

Необязательный

System.String

Этот параметр зарезервирован для внутреннего использования Microsoft.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

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

Командлет Set-CsClsConfiguration принимает из конвейера экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLogging.CentralizedLoggingConfiguration.

Отсутствуют. Вместо этого командлет Set-CsClsConfiguration изменяет существующие экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.CentralizedLogging.CentralizedLoggingConfiguration.

 
Показ: