Grant-CsPresencePolicy

Skype for Business Server 2015
 

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

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

Grant-CsPresencePolicy -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Команда из примера 1 назначает политику присутствия RedmondPresencePolicy отдельному пользователю с идентификатором Ken Myer.

Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"

В примере 2 политика присутствия RedmondPresencePolicy назначается всем пользователям, имеющим учетные записи в подразделении Redmond в Active Directory. Для этого сначала выполняется командлет Get-CsUser с параметром OU, который возвращает коллекцию всех учетных записей пользователей в подразделении Redmond (OU=Redmond,dc=litwareinc,dc=com). Коллекция затем передается в командлет Grant-CsPresencePolicy , который назначает политику каждому пользователю в коллекции.

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

В примере 3 политика RedmondPresencePolicy назначается всем пользователям, работающим в городе Редмонд. Для этого команда сначала использует командлет Get-CsUser и параметр LdapFilter. В результате возвращается коллекция всех пользователей, которые работают в городе Редмонд; фильтр "l=Redmond" возвращает пользователей из Редмонда. (В языке запросов LDAP, символ "l", буква L в нижнем регистре, обозначает местоположение.) Полученная коллекция затем передается в командлет Grant-CsPresencePolicy , который назначает политику RedmondPresencePolicy каждому пользователю в коллекции.

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

Команда из примера 4 отменяет назначение политик пользователям, работающим в городе Редмонд. Вызов командлета Grant-CsPresencePolicy с параметром PolicyName, имеющим значение Null ($Null), приводит к удалению политик присутствия, назначенных пользователям, обрабатываемым командой.

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null

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

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

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

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

При создании индивидуальной политики не происходит ее автоматического назначения. Индивидуальные политики присутствия должны назначаться напрямую пользователям (или группам пользователей) с помощью командлета Grant-CsPresencePolicy .

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

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

 

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

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Указывает идентификатор учетной записи пользователя, которой назначается политика присутствия. Идентификаторы обычно задается в одном из следующих четырех форматов: 1) SIP-адрес пользователя; 2) имя участника-пользователя (UPN); 3) доменное имя и имя пользователя в формате "домен\имя_пользователя" (например, litwareinc\kenmyer); 4) отображаемое имя Active Directory (например, Ken Myer). Идентификатор также можно указать с помощью различающегося имени пользователя в Active Directory.

При использовании отображаемого имени в качестве идентификатора пользователя можно применять подстановочный символ звездочки (*). Например, идентификация по имени "* Smith" вернет всех пользователей, у которых отображаемое имя завершается в строке значением "Smith".

PolicyName

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

System.String

Идентификатор назначаемой индивидуальной политики; например: -PolicyName "RedmondPresencePolicy". Параметр PolicyName это параметр Identity без префикса "tag:". Например, политика с идентификатором "tag:NorthAmericaPresencePolicy" имеет свойство PolicyName со значением "NorthAmericaPresencePolicy".

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Полное доменное имя контроллера для назначения политики. Например: -DomainController atl-dc-001.litwareinc.com.

Если этот параметр не задан, то при назначении политики командлет Grant-CsPresencePolicy будет обращаться к ближайшему доступному контроллеру домена.

PassThru

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

System.Management.Automation.SwitchParameter

Позволяет передать через конвейер объект пользователя, представляющий пользователя, которому назначается политика. По умолчанию командлет Grant-CsPresencePolicy не передает объекты через конвейер.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Строковое значение или объект Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy. Командлет Grant-CsPresencePolicy принимает из конвейера строковые значения, представляющие идентификаторы учетных записей пользователей. Командлет также принимает из конвейера объекты пользователей.

По умолчанию командлет Grant-CsPresencePolicy не возвращает объекты или значения. Но если указать параметр PassThru, то командлет вернет экземпляры Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

 
Показ: