Set-CsRgsAgentGroup

Skype for Business Server 2015
 

Дата изменения раздела:2015-03-09

Изменяет существующую группу агентов группы ответа. Группа агентов представляет собой коллекцию агентов, назначенных очереди группы ответа. Агенты — это пользователи, которые отвечают на вызовы, направляемые в указанную очередь. Данный командлет впервые появился в Lync Server 2010.

Set-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 показаны команды, позволяющие изменить свойство RoutingMethod группы агентов "Help Desk" (Служба технической поддержки) для группы ответа в службе ApplicationServer:atl-cs-001.litwareinc.com. Первая команда вызывает командлет Get-CsRgsAgentGroup , который извлекает группу агентов "Help Desk" (-Name "Help Desk") из службы ApplicationServer:atl-cs-001.litwareinc.com и сохраняет полученный объект в переменной $x.

Команда 2 изменяет значение свойства RoutingMethod. Заключительная команда вызывает командлет Set-CsRgsAgentGroup , который записывает изменения в реальную группу агентов "Help Desk".

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x

В примере 2 демонстрируется изменение группы рассылки, назначенной группе агентов для группы ответа. Для этого сначала вызывается командлет Get-CsRgsAgentGroup , возвращающий группу агентов, которую требуется изменить. В этом примере — группа "Help Desk" (-Name "Help Desk "), размещающаяся в службе ApplicationServer:atl-cs-001.litwareinc.com. После того, как командлет Get-CsRgsAgentGroup возвращает эту группу, полученный объект сохраняется в переменной $x.

Вторая команда присваивает новое значение (helpdesk@litwareinc.com) свойству DistributionGroupAddress. После этого вызывается командлет Set-CsRgsAgentGroup , который записывает изменения в группу агентов "Help Desk" в службе ApplicationServer:atl-cs-001.litwareinc.com.

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x

В примере 3 показаны команды, позволяющие добавить нового агента в группу агентов "Help Desk" для группы ответа. Первая команда вызывает командлет Get-CsRgsAgentGroup , который возвращает группу "Help Desk" (-Name "Help Desk") из службы ApplicationServer:atl-cs-001.litwareinc.com. Полученный объект сохраняется в переменной $x.

Вторая команда с помощью метода Add добавляет нового агента в свойство AgentsByUri. Для этого указывается адрес SIP нового агента ("sip:kenmyer@litwareinc.com"). Команда 3 вызывает командлет Set-CsRgsAgentGroup , который записывает изменения (добавление нового агента) в группу "Help Desk". Если командлет Set-CsRgsAgentGroup не используется, изменения осуществляются только в памяти и не применяются к реальной группе агентов.

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x

В примере 4 из группы агентов "Help Desk" для группы ответа в службе ApplicationServer:atl-cs-001.litwareinc.com удаляется агент. Первая команда вызывает командлет Get-CsRgsAgentGroup , который возвращает группу "Help Desk" (-Name "Help Desk") из службы ApplicationServer:atl-cs-001.litwareinc.com. Полученный объект группы агентов сохраняется в переменной $x.

После извлечения группы агентов из нее с помощью метода Remove удаляется агент с адресом SIP "sip:kenmyer@litwareinc.com". Команда 3 вызывает командлет Set-CsRgsAgentGroup , который записывает изменения (удаление агента) в группу. Если командлет Set-CsRgsAgentGroup не используется, изменения осуществляются только в памяти и не применяются к реальной группе агентов. Соответственно, для удаления агента необходимо вызвать командлет Set-CsRgsAgentGroup .

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x

При поступлении вызова на номер телефона, связанный с системой "Группа ответа", служба в первую очередь определяет рабочий процесс, соответствующий этому номеру. Далее на основе конфигурации этого рабочего процесса вызов может перенаправляться на интерактивный автоответчик, который задает абоненту один или несколько вопросов (например, "Ваш вопрос касается оборудования или программного обеспечения?"). Также вызов может помещаться в очередь группы ответа. При этом абонент ожидает, пока на вызов не ответит один из назначенных специалистов — агентов. Группа, объединяющая нескольких агентов, называется группой агентов группы ответа. Такие группы связываются с рабочими процессами. Входящие в них агенты имеют схожие должностные обязанности. Например, специалисты службы технической поддержки и агенты службы поддержки клиентов могут объединяться в группы соответствующего назначения.

Для создания групп агентов используется командлет New-CsRgsAgentGroup . Для внесения изменений в существующую группу агентов используется командлет Set-RgsAgentGroup . Помимо прочего, с его помощью можно добавлять в группу отдельных агентов и удалять их. Обратите внимание, что командлет Set-CsRgsAgentGroup не изменяет свойства группы агентов напрямую. Чтобы изменить группу, сначала необходимо создать соответствующую ей ссылку на объект. Для этого вызывается командлет Get-CsRgsAgentGroup , который извлекает группу и сохраняет полученный объект в переменной. После создания ссылки на объект можно изменять свойства группы в памяти. Выполнив все необходимые изменения, следует вызвать командлет Set-CsRgsAgentGroup , который записывает их в реальную группу агентов для группы ответа. Если командлет Set-CsRgsAgentGroup не используется, изменения хранятся только в памяти и утрачиваются после закрытия Windows PowerShell или удаления переменной со ссылкой на объект.

 

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

Instance

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

Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup

Ссылка на объект группы агентов для группы ответа, который требуется изменить. Обычно эта ссылка извлекается с помощью командлета Get-CsRgsAgentGroup , а полученное значение присваивается переменной. Например, следующая команда возвращает ссылку на объект для группы агентов "Help Desk" и сохраняет ее в переменной $x:

$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Отключает отображение любых некритических ошибок при выполнении команды.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup. Командлет Set-CsRgsAgentGroup принимает передаваемые по конвейеру экземпляры группы агентов для группы ответа.

Командлет Set-CsRgsAgentGroup не возвращает какие-либо объекты или значения. Он изменяет существующие экземпляры объекта Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.

 
Показ: