New-CsPresenceProvider

Skype for Business Server 2015
 

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

Разрешает использовать в организации новый поставщик присутствия. Поставщики присутствия представляют свойство PresenceProviders коллекции настроек конфигурации служб пользователей.Данный командлет впервые появился в Lync Server 2013.

New-CsPresenceProvider -Fqdn <String> -Parent <String> <COMMON PARAMETERS>
New-CsPresenceProvider -Identity <XdsIdentity> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, создает новый поставщик присутствия (с полным доменным именем "fabrikam.com"), который добавляется в глобальную коллекцию настроек конфигурации службы User Services.

New-CsPresenceProvider -Parent "global" -Fqdn "fabrikam.com"


В примере 2 во все коллекции конфигураций службы обслуживания пользователей в организации добавляется поставщик присутствия с полным доменным именем "fabrikam.com". Для этого команда сначала использует командлет Get-CsUserServicesConfiguration , чтобы получить коллекцию всех параметров службы обслуживания пользователей. Затем эти параметры по конвейеру передаются в командлет ForEach-Object, который получает каждый элемент коллекции и создает новый поставщик присутствия для этой коллекции, используя "fabrikam.com" в качестве полного доменного имени поставщика присутствия и идентификатор Identity коллекции службы обслуживания пользователей в качестве значения Parent для поставщика присутствия.

Get-CsUserServicesConfiguration | ForEach-Object {New-CsPresenceProvider -Parent $_.Identity -Fqdn "fabrikam.com"}

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

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

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

Панель Панель управления Skype для бизнеса Server: функции, выполняемые командлетом New-CsPresenceProvider , недоступны в панели Панель управления Skype для бизнеса Server.

 

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

Fqdn

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

System.String

Полное доменное имя поставщика присутствия. Например:

-Fqdn "fabrikam.com"

При использовании параметра Fqdn необходимо также использовать параметр Parent. Но параметр Fqdn нельзя использовать в одной команде с параметром Identity.

Обратите внимание, что полные доменные имена (FQDN) должны быть уникальными на данном уровне.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор нового поставщика присутствия. Идентификатор Identity поставщика присутствия состоит из двух частей: родительский уровень (Parent), к которому применено правило (например, service:UserServer:atl-cs-001.litwareinc.com) и полное доменное имя поставщика (FQDN). Для создания поставщика присутствия на глобальном уровне используйте синтаксис, аналогичный следующему:

-Identity "global/fabrikam.com"

Чтобы создать поставщик на уровне сайта, используйте синтаксис, аналогичный следующему:

-Identity "site:Redmond/fabrikam.com"

Чтобы создать поставщик на уровне службы (только для службы UserServer), используйте следующий синтаксис:

-Parent "UserServer:atl-cs-001.litwareinc.com"

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

Parent

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

System.String

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

-Parent "global"

Чтобы создать поставщик на уровне сайта, используйте синтаксис, аналогичный следующему:

-Parent "site:Redmond"

Чтобы создать поставщик на уровне службы (только для службы UserServer), используйте следующий синтаксис:

-Parent "UserServer:atl-cs-001.litwareinc.com"

При использовании параметра Parent необходимо также использовать параметр Fqdn. Но параметр Parent нельзя использовать вместе с параметром Identity.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: