New-CsUserServicesConfiguration

Skype for Business Server 2015
 

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

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

New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-PresenceProviders <PSListModifier>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, создает коллекцию, включающую параметры конфигурации службы обслуживания пользователей для сайта Redmond (-Identity site:Redmond). Наряду с указанием идентификатора, команда также задает максимальное число контактов (-MaxContacts 500) и время суток, когда производится обслуживание (-MaintenanceTimeOfDay "11:00 PM"). Обратите внимание на то, что если параметры службы обслуживания пользователей уже были настроены для сайта Redmond, эта команда завершится сбоем. Это связано с ограничением в одну коллекцию параметров на сайт.

New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"

В примере 2 также создается коллекция, включающая параметры конфигурации службы обслуживания пользователей для сайта Redmond. Однако в этом примере коллекция изначально создается в памяти и лишь затем применяется к сайту Redmond. Для этого первая команда в примере вызывает командлет New-CsUserServicesConfiguration с параметром InMemory, который создает коллекцию (с идентификатором site:Redmond), существующую только в памяти. Поскольку она существует только в памяти, объект службы обслуживания пользователей должен храниться в переменной. В данном случае это переменная с именем $x.

После создания виртуальной коллекции значения свойств MaxContacts и MaintenanceTimeOfDay изменяются с помощью команд 2 и 3. Последняя команда в примере вызывает командлет Set-CsUserServicesConfiguration , который преобразует эти виртуальные параметры в коллекцию параметров конфигурации службы обслуживания пользователей, применяемых к сайту Redmond. Этот последний этап крайне важен: если не вызвать командлет Set-CsUserServicesConfiguration , к сайту Redmond не будут применены параметры, а виртуальные параметры исчезнут, как только завершится сеанс Windows PowerShell или будет удалена переменная $x.

$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500 
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x

Skype для бизнеса Server 2015 полагается на службу обслуживания пользователей, чтобы содействовать обслуживанию сведений о присутствии для пользователей и управлять собраниями и конференциями. В свою очередь, командлеты CsUserServicesConfiguration используются для администрирования параметров конфигурации этой службы на глобальном уровне, уровне сайтов и службы (обратите внимание, что только та служба, которая может размещать параметры конфигурации обслуживания пользователей, является собственно службой обслуживания пользователей). Эти параметры помогают определить число контактов, разрешенное пользователю, число собраний, которое пользователь может одновременно запланировать, период времени в течение которого конкретное собрание может оставаться активным, и многое другое.

Командлет New-CsUserServicesConfiguration дает администраторам возможность создавать коллекции параметров конфигурации для службы обслуживания пользователей на уровне сайта или службы. (Создавать коллекции на глобальном уровне нельзя.) Обратите внимание на то, что сайту или службе может быть назначена только одна коллекция параметров службы обслуживания пользователей. Например, если вы попытаетесь создать параметры для сайта Redmond, к которому уже применена коллекция параметров службы обслуживания пользователей, команда завершится сбоем.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для параметров конфигурации службы обслуживания пользователей, которые необходимо создать. Чтобы создать параметры на уровне сайта, используйте следующий синтаксис: -Identity site:Redmond. Чтобы создать параметры на уровне службы, используйте следующий синтаксис: -Identity service:UserServer:atl-cs-001.litwareinc.com.

AnonymousUserGracePeriod

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

System.TimeSpan

Представляет период времени, в течение которого анонимный (не прошедший проверку подлинности) пользователь может оставаться на собрании в отсутствие прошедшего проверку пользователя. Например, если это значение равно 15 минутам, анонимный пользователь может оставаться на собрании не более 15 минут, после чего к нему должен присоединиться прошедший проверку пользователь. Если прошедший проверку пользователь не присоединится, прежде чем истечет период отсрочки, анонимный пользователь покинет собрание. Этот параметр применяется как к запланированным, так и к незапланированным собраниям, созданным с помощью команды "Провести собрание" в Microsoft Lync.

Значение параметра AnonymousUserGracePeriod следует указывать в следующем формате: дни.часы:минуты:секунды (например, 0.00:30:00 для 30 минут). Для периода отсрочки можно задать любое значение от 0 секунд до 1 суток; значение по умолчанию — 90 минут (01:30:00).

Confirm

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

System.Management.Automation.SwitchParameter

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

DeactivationGracePeriod

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

System.TimeSpan

Максимальное время, в течение которого собрание может оставаться активным. Для указания этого значения следует использовать следующий формат: дни.часы:минуты:секунды. Например, чтобы собрание продолжалось 60 часов, используйте следующий формат: 2.12:00:00 (2 дня.12 часов:00 минут:00 секунд.)

Значение параметра DeactivationGracePeriod должно находиться в диапазоне от 8 часов до 365 дней включительно. Значение по умолчанию — 1 день (1.00:00:00).

DefaultSubscriptionExpiration

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

System.Int64

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

Срок действия по умолчанию должен быть целочисленным значением в диапазоне от 300 секунд (5 минут) до 86 400 секунд (24 часа) включительно. Значение по умолчанию — 28 800 секунд (8 часов).

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

MaintenanceTimeOfDay

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

System.DateTime

Указывает время суток, когда должно проводиться регулярное обслуживание базы данных (например, очистка устаревших записей). Значение указывается в формате даты и времени. Время можно задавать в 24-часовом (например, "14:00") или 12-часовом (например, "2:00 PM") формате.

Значение параметра MaintenanceTimeOfDay по умолчанию — 1:00 AM (01:00:00).

MaxContacts

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

System.UInt16

Максимальное число контактов пользователя; значение по умолчанию — 250. Свойство MaxContacts представляет абсолютное максимальное число контактов пользователя. Однако с помощью командлетов CsClientPolicy можно ограничить максимальное число контактов для определенных пользователей, сделав его меньше значения свойства MaxContacts.

MaxPersonalNotes

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

System.UInt32

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

MaxScheduledMeetingsPerOrganizer

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

System.UInt32

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

MaxSubscriptionExpiration

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

System.Int64

Подписки создаются каждый раз, когда пользователь запрашивает данные, например сведения о присутствии. Выполняя такой запрос, пользователь (или, если быть точнее, клиентское приложение пользователя) может также запросить срок действия подписки до ее продления. Свойство MaxSubscriptionExpiration представляет максимальный срок действия, который может быть предоставлен клиентам. Например, если максимальный срок действия равен 28 800 секундам, а клиент запрашивает 86 400 секунд, будет задан максимальный разрешенный срок действия — 28800 секунд.

Максимальный срок действия должен быть целочисленным значением в диапазоне от 300 секунд (5 минут) до 86 400 секунд (24 часа) включительно. Значение по умолчанию — 43 200 секунд (12 часов).

MaxSubscriptions

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

System.UInt16

Максимальное число диалоговых окон подписки SIP, которые пользователь может открыть одновременно. Диалоговое окно подписки используется для запроса ресурсов SIP. Значение по умолчанию — 200.

MinSubscriptionExpiration

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

System.Int64

Подписки создаются каждый раз, когда пользователь запрашивает данные, например сведения о присутствии. Выполняя такой запрос, пользователь (или, если быть точнее, клиентское приложение пользователя) может также запросить срок действия подписки до ее продления. Свойство MinSubscriptionExpiration представляет минимальный срок действия, который может быть предоставлен клиентам. Например, если минимальный срок действия равен 1200 секундам, а клиент запрашивает 200 секунд, будет задан минимальный разрешенный срок действия — 1200 секунд.

Минимальный срок действия должен быть целочисленным значением в диапазоне от 300 секунд (5 минут) до 86 400 секунд (24 часа) включительно. Значение по умолчанию — 1200 секунд (20 минут).

PresenceProviders

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

System.Management.Automation.PSListModifier

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

SubscribeToCollapsedDG

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

System.Boolean

Если задано значение True (значение по умолчанию), клиентским приложениям разрешено подписываться на группы рассылки, которые в настоящее время не развернуты в списке контактов. Это позволяет клиенту поддерживать актуальность сведений о присутствии для каждого члена группы. Если задано значение False, клиентским приложениям запрещено подписываться на “свернутые” группы.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: