Управление параметрами конфигурации централизованной службы ведения журналов в Skype для бизнеса Server 2015

Skype for Business Server 2015
 

Дата изменения раздела:2015-08-17

Краткое содержание. Сведения об извлечении, обновлении и создании параметров конфигурации для централизованной службе ведения журнала в Skype для бизнеса Server 2015.

Централизованная служба ведения журнала управляется и настраивается с помощью параметров, создаваемых и используемых контроллером централизованной службы ведения журнала (CLSController) для отправки команд в агент службы централизованной службы ведения журнала (CLSAgent) отдельных компьютеров. Этот агент обрабатывает отправляемые ему команды и (в случае получения команды Start) использует конфигурацию сценариев, поставщики, длительность трассировки и флаги для начала сбора данных для журналов трассировки в соответствии с предоставленной информации о конфигурации.

importantВажно!
Не все командлеты Windows PowerShell, указанные для централизованной службы ведения журнала, предназначены для использования с локальными развертываниями системы Skype для бизнеса Server 2015. Хотя может создаваться впечатление о том, что они работают, следующие командлеты не предназначены для локальных развертываний системы Skype для бизнеса Server 2015: Параметры, определенные в этих командлетах, не препятствуют работе и не вызывают побочные эффекты, однако они предназначены для использования с Microsoft Office 365 и не позволяют получить ожидаемые результаты в локальных развертываниях. Это не означает полную бесполезность таких командлетов в локальных развертываниях, но вопрос об их использовании выходит за рамки данной документации.

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

Чтобы настроить область централизованной службы ведения журнала с помощью командной консоли Skype для бизнеса Server, необходимо быть участником группы безопасности RBAC CsAdministrator или CsServerAdministrator или настраиваемой роли RBAC, которая содержит одну из этих групп. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке командной консоли Skype для бизнеса Server или Windows PowerShell следующую команду:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "
    <Skype for Business cmdlet>
  "}

Например:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
noteПримечание.
Существуют принципиальные различия между командами командной строки, которые можно выполнить в Windows PowerShell, и командами CLSController. Windows PowerShell предоставляет полнофункциональный метод для настройки и определения сценариев, а также для повторного использования этих сценариев и их отладки. Хотя CLSController позволяет быстро и эффективно выполнять команды и получать результаты, набор команд этого средства ограничен командами, доступными из командной строки. В отличие от командлетов Windows PowerShell, CLSController не может определять новые сценарии, управлять областью на уровне сайта и на глобальном уровне, а также имеет другие ограничения конечного набора команд, который не подлежит динамической настройке. Средство CLSController предлагает возможность быстрого выполнения, тогда как система Windows PowerShell позволяет использовать возможности централизованной службы ведения журнала, недоступные при использовании CLSController.

Область одного компьютера можно определить при выполнении команд Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging и Update-CsClsLogging с помощью параметра –Computers. Параметр –Computers принимает разделенный запятой список полных доменных имен для целевого компьютера.

tipСовет.
С помощью параметра –Pools можно задать разделенный запятой список пулов, в которых должны выполняться команды ведения журнала.

Область сайта и глобальная область определяются в командлетах централизованной службы ведения журнала New- , Set- и Remove- . В следующих примерах показано, как задать область сайта и глобальную область.

importantВажно!
Показанные команды могут содержать параметры и концепции, описанные в других разделах. Команды в примерах предназначены для демонстрации использования параметра –Identity для определения области, а другие параметры включены для полноты и для указания области. Дополнительные сведения о командлетах Set-CsClsConfiguration см. в описании командлета Set-CsClsConfiguration в документации по применению.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration
    

Используйте командлеты New-CsClsConfiguration и Set-CsClsConfiguration для создания новой конфигурации или для обновления существующей.

При выполнении командлета Get-CsClsConfiguration отображаются сведения, подобные показанным на следующем снимке экрана. В этом примере в развертывании имеется глобальная конфигурация по умолчанию, а конфигурации сайтов не определены:

Выход выборки из Get-CsClsConfiguration.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration -LocalStore
    

При использовании первого примера, в котором для командлета Get-CsClsConfiguration не указаны параметры, команда обращается за данными к центральному хранилищу управления. Если указать параметр –LocalStore, команда обратится к локальному хранилищу компьютера, а не к центральному хранилищу управления.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration -Identity 
        <scope and name>
       | Select-Object -ExpandProperty Scenarios
    

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

    Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
    

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

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Set-CsClsConfiguration -Identity 
        <scope>
       -EtlFileRolloverSizeMB 
        <size for logging file in megabytes>
      
    

    Например:

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
    

При выполнении этой команды CLSAgent на каждом компьютере и в каждом пуле развертывания задает для размера переключения на новый файл трассировки значение 40 МБ. Эта команда влияет на компьютеры и пулы на всех сайтах и задает в качестве размера переключения на новый журнал трассировки значение 40 МБ.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Set-CsClsConfiguration -Identity 
        <scope/site name>
       -EtlFileRolloverSizeMB 
        <size for logging file in megabytes>
       
    

    Например:

    Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40  
    
    noteПримечание.
    Как отмечено в примере, расположением файлов журнала по умолчанию является каталог %TEMP%\Tracing. Однако так как фактически файл записывает CLSAgent, который выполняется как сетевая служба, переменная %TEMP% расширяется до %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.

При выполнении этой команды CLSAgent на каждом компьютере и в каждом пуле сайта Redmond задает для размера переключения на новый файл трассировки значение 40 МБ. Эта команда не повлияет на компьютеры и пулы на других сайтах, которые продолжат использовать текущее значение размера переключения на новый журнал трассировки, определенное либо по умолчанию (20 МБ), либо во время запуска сеанса ведения журнала.

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    New-CsClsConfiguration -Identity 
        <scope and name>
       [CsClsConfiguration options for this site]
    
    noteПримечание.
    Командлет New-CsClsConfiguration предоставляет доступ к большому количеству необязательных параметров конфигурации. Дополнительные сведения о параметрах конфигурации см. в описании командлета Get-CsClsConfiguration и в разделе Понимание параметров конфигурации службы централизованного ведения журналов.

    Например для создания новой конфигурации, которая определяет сетевую папку для файлов кэша, а также период и размер переключения для файлов журнала, введите следующую команду:

    New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
    

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

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск , последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса .

  2. Введите следующую команду в командной строке:

    Remove-CsClsConfiguration -Identity 
        <scope and name>
      
    

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

    Remove-CsClsConfiguration -Identity "site:Redmond"
    
    noteПримечание.
    Это новая конфигурация, которая была создана в процедуре "Создание новой конфигурации центрального хранилища управления".

Если удалить конфигурацию уровня сайта, сайт будет использовать глобальные параметры.

 
Показ: