Get-CsPresencePolicy

Skype for Business Server 2015
 

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

Возвращает информацию о политиках присутствия, настроенных для использования в компании. Данный командлет впервые появился в Lync Server 2010.

Get-CsPresencePolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsPresencePolicy [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

Команда, представленная в примере 1, служит для возврата информации обо всех политиках присутствия, настроенных для использования в организации. Для этого вызывается командлет Get-CsPresencePolicy без параметров.

Get-CsPresencePolicy

В примере 2 показан возврат одной политики присутствия для отдельных пользователей: политика со значением свойства Identity "RedmondPresencePolicy".

Get-CsPresencePolicy -Identity "RedmondPresencePolicy"

В примере 3 показано, как возвращаются данные обо всех политиках присутствия, настроенных в области сайта. Для этой цели команда использует параметр Filter и значение фильтра "site:*". Это значение фильтра ограничивает возвращаемые данные до всех политик присутствия со свойством Identity, значение которого начинается со строкового значения "site:".

Get-CsPresencePolicy -Filter "site:*"

В примере 4 данные возвращаются для всех политик присутствия, которые ограничивают максимально допустимое количество запрашиваемых абонентов на уровне 100 или менее. Для этого команда сначала вызывает командлет Get-CsPresencePolicy без параметров, который возвращает коллекцию всех политик присутствия, настроенных для использования в организации. Эта коллекция затем передается в командлет Where-Object , который выбирает только те политики, в которых для свойства MaxPromptedSubscriber задано значение, меньшее или равное 100.

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}

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

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

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

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

Командлет Get-CsPresencePolicy обеспечивает возврат данных обо всех политиках присутствия, настроенных для использования в компании.

 

Параметр Применение Тип Описание

Filter

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

System.String

Позволяет использовать подстановочные знаки при указании возвращаемой политики (политик). Например, этот синтаксис используется для возврата всех политик присутствия, настроенных в области сайта:

-Filter "site:*"

Нельзя использовать параметры Filter и Identity в одной команде.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор получаемой политики присутствия. Для возврата глобальной политики необходимо использовать следующий синтаксис:

-Identity global

Для возврата политики, настроенной в области сайта, используйте следующий синтаксис:

-Identity "site:Redmond"

Для возврата политики, настроенной в области отдельного пользователя, используйте следующий синтаксис:

-Identity "RedmondPresencePolicy"

Использование подстановочных знаков при задании свойства Identity не допускается.

Если параметры Identity и Filter не заданы, командлет Get-CsPresencePolicy возвращает все политики присутствия, настроенные для использования в организации.

LocalStore

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

System.Management.Automation.SwitchParameter

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

Tenant

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

System.Guid

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

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

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

Get-CsTenant | Select-Object DisplayName, TenantID

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

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

 
Показ: