New-CsDeviceUpdateConfiguration

Skype for Business Server 2015
 

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

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

New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <DateTime>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond

В примере 2 также создается новый набор параметров конфигурации обновления устройства с идентификатором site:Redmond. Однако в этом примере для настройки новых параметров используются два дополнительных параметра: MaxLogFileSize для настройки максимального размера файла журнала 2 048 000 байт и LogCleanUpInterval для указания интервала очистки журнала 7 дней (7 дней. 00 часов : 00 минут : 00 секунд).

New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00

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

Параметры конфигурации обновления устройства, которые используются для управления обновления устройств, могут быть назначены на глобальном уровне или на уровне сайта. Чтобы создать новую коллекцию параметров для сайта, используйте командлет New-CsDeviceUpdateConfiguration . Обратите внимание, что вы можете создавать новые параметры только на уровне сайта. Если вы попытаетесь создать новую коллекцию параметров на глобальном уровне, возникнет ошибка. Ошибка также возникнет в случае, если вы попытаетесь создать новую коллекцию параметров, например, для сайта Redmond, который уже содержит коллекцию параметров конфигурации обновления устройства. Это связано с тем, что для отдельного сайта можно создать только одну коллекцию параметров конфигурации обновления устройства.

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

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

 

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

Identity

Обязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

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. По умолчанию используется значение NULL.

LogFlushInterval

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

System.TimeSpan

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

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

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

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

Значение по умолчанию: 00:05:00

MaxLogCacheLimit

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

System.UInt32

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

Значение по умолчанию: 512 000

MaxLogFileSize

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

System.UInt32

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

Значение по умолчанию: 1 024 000

ValidLogFileExtensions

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

System.Management.Automation.PSListModifier

Указывает допустимые расширения файла журнала для обновления устройств. Этот список может быть изменен. Если ваше устройство под управлением Skype для бизнеса создает файлы журнала с другим расширением, вы можете изменить этот список.

По умолчанию: 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

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

Нет. Командлет New-CsDeviceUpdateConfiguration не принимает конвейерный ввод данных.

Командлет New-CsDeviceUpdateConfiguration создает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

 
Показ: