New-CsPresencePolicy

Skype for Business Server 2015
 

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

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

New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, создает новую политику присутствия на уровне пользователя с параметром Identity RedmondPresencePolicy. В этом примере свойство MaxPromptedSubscriber имеет значение 400, а свойство MaxCategorySubscription имеет значение 500.

New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500

В примере 2 новая политика присутствия на уровне пользователя вначале создается в памяти, а затем преобразуется в действительную политику присутствия. Для этого первая команда в примере создает политику присутствия с параметром Identity RedmondPresencePolicy и сохраняет эту политику в переменной с именем $x. Параметр InMemory показывает, что политика создается только в памяти и не применяется сразу к Skype для бизнеса Server 2015.

Команды 2 и 3 настраивают свойства MaxPromptedSubscriber и MaxCategorySubscription виртуальной политики. После настройки свойств политики в строке 4 используется командлет Set-CsPresencePolicy и параметр Instance для создания действительной политики присутствия, основанной на данных, хранящихся в переменной $x. Этот последний шаг важен: если не вызвать командлет Set-CsPresencePolicy , политика будет существовать только в памяти и исчезнет после завершения сеанса Windows PowerShell или удаления переменной $x.

$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x

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

Командлеты CsPresencePolicy позволяют управлять важными аспектами подписок присутствия: запрошенные подписки и подписки на категории. Когда пользователь добавляется в список контактов Skype для бизнеса другого пользователя, поведение по умолчанию подразумевает получение первым пользователем всплывающего уведомления, сообщающего о том, что он был добавлен в список контактов. До тех пор пока пользователь не закроет всплывающее окно, каждое уведомление считается как запрошенная подписка. Свойство MaxPromptedSubscriber политики присутствия позволяет указать максимальное допустимое число диалоговых окон с уведомлениями, оставленных без ответа пользователя. (Если пользователь получает максимальное число, то он не будет получать новые уведомления о контактах пока не будут обработаны некоторые из этих диалоговых окон.)

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

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

Командлет New-CsPresencePolicy предоставляет способ создания настраиваемых политик присутствия на уровне сайта или на уровне пользователя. Политики, созданные на уровне сайта, автоматически применяются к этому сайту; политики, созданные на уровне пользователя, должны назначаться пользователям при помощи командлета Grant-CsPresencePolicy . Обратите внимание, что невозможно создать новую политику присутствия на глобальном уровне, а также невозможно создать вторую политику присутствия на отдельном сайте. (Например, сайт Redmond может размещать только одну политику присутствия.)

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор для новой политики присутствия. Чтобы создать новую политику на уровне пользователя, используйте следующий синтаксис: -Identity "RedmondPresencePolicy". Чтобы создать новую политику на уровне сайта, используйте следующий синтаксис: -Identity "site:Redmond".

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

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

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

MaxCategorySubscription

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

System.UInt16

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

Параметру MaxCategorySubscription можно присвоить любое целое число между 0 и 3000; значение по умолчанию — 1000.

MaxPromptedSubscriber

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

System.UInt16

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

Параметру MaxPromptedSubscriber может быть присвоено любое целое число от 0 до 600 включительно; значение по умолчанию составляет 200. Если это значение задано равным 0, пользователи не будут получать уведомления при добавлении их в список контактов другого пользователя.

Tenant

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

System.Guid

Уникальный глобальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online, для которого создается новая политика присутствия. Пример:

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Идентификатор каждого из клиентов Skype для бизнеса Online можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет New-CsPresencePolicy создает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

 
Показ: