Set-CsDeviceUpdateConfiguration

Skype for Business Server 2015
 

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

Изменяет коллекцию параметров конфигурации веб-службы обновления устройств. Эти параметры используются для управления веб-службой обновления устройств, компонентом Skype для бизнеса Server 2015, позволяющим администраторам распределять обновления встроенного ПО для телефонов и других устройств, на которых выполняется Skype для бизнеса Phone Edition. Данный командлет впервые появился в Lync Server 2010.

Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsDeviceUpdateConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <DateTime>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

В примере 1 показывается, как можно использовать командлет Set-CsDeviceUpdateConfiguration для изменения глобальных параметров конфигурации. В этом случае изменяются значения двух свойств: для свойства MaxLogFileSize задается значение 2048000 байт, а для свойства MaxLogCacheLimit задается значение 1024000 байт.

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

В примере 2 изменяется свойство LogFlushInterval для параметров конфигурации обновления устройств, для которых параметр Identity имеет значение site:Redmond. Чтобы выполнить это, параметр Identity используется для задания параметров для сайта Redmond и параметр LogFlushInterval — для задания значения свойства, которое требуется изменить. В данном случае для параметра LogFlushInterval задается значение 2 минуты (00 часов: 02 минуты: 00 секунд).

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

В примере 3 все параметры обновления конфигурации устройств в организации изменяются таким образом, чтобы задать для LogCleanUpInterval значение, равное 14 дням. Чтобы выполнить это, сначала используется командлет Get-CsDeviceUpdateConfiguration для получения коллекции всех параметров обновления конфигурации устройств, используемых в настоящее время в организации. Затем эта коллекция передается в командлет Set-CsDeviceUpdateConfiguration , который с помощью параметра LogCleanUpInterval задает значение интервала времени очистки журнала для каждого элемента в коллекции, равное 14 дням (14 дней . 00 часов : 00 минут : 00 секунд).

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

В примере 4 показывается, как можно изменить значение свойства для всех параметров обновления конфигурации устройств, настроенных на уровне сайта; в данном случае команда устанавливает значение для LogCleanUpInterval, равное 20 дням (20 дней. 00 часов : 00 минут : 00 секунд). Чтобы выполнить это, используется командлет Get-CsDeviceUpdateConfiguration вместе с параметром Filter; значение фильтра "site:*" ограничивает возвращаемые данные параметрами, свойство Identity которых начинается со строкового значения "site:". Эта отфильтрованная коллекция затем передается в командлет Set-CsDeviceUpdateConfiguration , который изменяет значение интервала очистки журнала для каждого элемента коллекции.

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

В примере 5 удаляется CELog из списка допустимых типов файлов журналов, используемых параметрами обновления конфигурации устройств. В этой команде сначала используется командлет Get-CsDeviceUpdateConfiguration , чтобы получить коллекцию всех параметров обновления конфигурации устройств, используемых в настоящее время в организации. Затем эта коллекция передается в командлет Set-CsDeviceUpdateConfiguration , который с помощью параметра ValidLogFileTypes удаляет CELog из списка допустимых файлов журналов. Значение этого параметра передается в ValidLogFileTypes, @{Remove="CELog"}, предписывая командлету Set-CsDeviceUpdateConfiguration удалить CELog из набора допустимых типов файлов. Чтобы удалить несколько типов файлов с помощью одной команды, следует просто включить эти дополнительные типы в виде списка, элементы которого разделяются запятыми. Например:

@{Remove="CELog","Watson"}

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

обновления устройств предоставляет администраторам способ для распределения обновлений встроенного ПО по устройствам, на которых выполняется Skype для бизнеса. Периодически администраторы передают набор правил обновления устройств на Skype для бизнеса Server 2015 Phone Edition. После тестирования и утверждения этих правил они могут применяться к соответствующим устройствам, когда эти устройства подключаются к системе. Устройства проверяют наличие обновлений при своем первом включении, затем эта проверка повторяется, когда пользователь выполняет вход в систему. В дальнейшем устройства повторяют проверку каждые 24 часа.

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

Кто может запускать этот командлет: по умолчанию локально запускать командлет Set-CsDeviceUpdateConfiguration имеют право участники следующих групп: RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которые были назначены для этого командлета (включая все созданные вами роли RBAC), выполните следующую команду из командной строки Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDeviceUpdateConfiguration"}

 

Параметр Обязательный? Тип Описание

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение каких-либо сообщений о некритических ошибках.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для параметров обновления конфигурации устройств, которые требуется изменить. Применительно к глобальным параметрам следует использовать следующий синтаксис: -Identity global. Применительно к параметрам, настраиваемым для уровня сайта, следует использовать следующий синтаксис: -Identity "site:Redmond". Обратите внимание, что здесь при определении параметра Identity не могут использоваться подстановочные знаки.

Instance

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

DeviceUpdateSettings object

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

LogCleanUpInterval

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

System.TimeSpan

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

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

Минимальное значение: 1.00:00:00 (1 день)

Максимальное значение: 365.00:00:00 (1 год)

По умолчанию: 10.00:00:00 (10 дней)

LogCleanUpTimeOfDay

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

System.DateTime

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

Значение, передаваемое параметру LogCleanupTimeOfDay должно иметь 24-часовой формат времени чч:мм, где чч представляет часы, а мм — минуты. В этом формате полночь отображается как 00:00; 8:30 утра представляется как 08:30; 11:52 вечера — как 23:52.

LogFlushInterval

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

System.TimeSpan

Показывает, как часто данные, сохраняемые в кэше файла журнала, записываются в текущий файл журнала. По умолчанию сведения об обновлении устройства записываются в файл журнала не сразу. Они кэшируются в памяти до наступления одного из следующих событий: 1) истечения временного интервала записи данных в журнал; 2) достижения максимального размера кэша. Если для этого параметра задано значение 10 минут (00:10:00), данные будут записываться из кэша в файл журнала каждые 10 минут. После записи данных в журнал кэш очищается.

Значение должно вводиться в формате чч:мм:сс, где чч — это часы, мм — минуты, сс — секунды.

Минимальное значение: 00:01:00 (1 минута)

Максимальное значение: 1:00:00 (1 час)

По умолчанию: 00:05:00

MaxLogCacheLimit

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

System.UInt32

Указывает максимальный объем информации (в байтах), который может содержаться в кэше файла журнала перед выполнением очистки этого кэша и записи соответствующих данных в файл журнала. По умолчанию файлы журналов "пополняются" каждые 5 минут. (Для получения дополнительных сведений см. описание параметра LogFlushInterval.) Однако, если информация в кэше достигает своего максимального размера, она автоматически будет записана в файл журнала (и кэш очищен), даже если интервал пополнения журнала еще не истек.

По умолчанию: 512000

MaxLogFileSize

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

System.UInt32

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

По умолчанию: 1024000

ValidLogFileExtensions

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

System.Management.Automation.PSListModifier

Указывает допустимые расширения файлов журнала, которые могут использоваться веб-службой обновления устройств. Этот список можно изменять; однако в общем случае причин для этого нет, если только не используется устройство, совместимое с Lync Phone Edition, которое создает файлы журналов с другими расширениями.

По умолчанию: DMP, CLG, CLG2, BAK, KDMP, DAT, BIN, CAT, XML, TXT, HEX

ValidLogFileTypes

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

System.Management.Automation.PSListModifier

Показывает типы файлов журнала, сохраняемые системой обновления устройства. Типы файлов по умолчанию:

Watson. Файлы журнала, автоматически создаваемые устройством в случае сбоя системы.

CELog. Skype для бизнеса Журналы телефонов, содержащие результаты функциональных тестов, а также запись критических системных событий.

Дополнительные типы файлов могут быть добавлены, если используются устройства, совместимые с Skype для бизнеса Phone Edition, которые создают другие типы файлов журналов. Кроме того, вы можете удалять файлы. Например, если не требуется хранить файлы CELog, можно удалить тип файлов CELog.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration. Командлет Set-CsDeviceUpdateConfiguration принимает конвейерные экземпляры объекта конфигурации обновления устройств.

Set-CsDeviceUpdateConfiguration не возвращает значение или объект. Вместо этого он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

 
Показ: