Remove-CsRgsQueue

Skype for Business Server 2015
 

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

Удаляет существующую очередь группы ответа. В приложении "Группа ответа" телефонные вызовы помещаются в очередь (абоненты переводятся в режим ожидания) до тех пор, пока не освободится агент группы ответа, который сможет ответить на него. Данный командлет впервые появился в Lync Server 2010.

Remove-CsRgsQueue -Instance <Queue> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 показана команда, позволяющая удалить все очереди группы ответа из службы ApplicationServer:atl-cs-001.litwareinc.com. Для этого сначала вызывается командлет Get-CsRgsQueue , который возвращает коллекцию всех очередей в службе ApplicationServer:atl-cs-001.litwareinc.com. Эта коллекция передается по конвейеру в командлет Remove-CsRgsQueue , который удаляет все включенные в нее очереди.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsQueue

В примере 2 удаляется одна очередь группы ответа "Help Desk Queue" (Очередь службы технической поддержки), которая располагается в службе ApplicationServer:atl-cs-001.litwareinc.com. Для этого вызывается командлет Get-CsRgsQueue с параметрами Identity и Name. Возвращаемая им очередь передается по конвейеру в командлет Remove-CsRgsQueue , который удаляет ее.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue" | Remove-CsRgsQueue

В примере 3 из службы ApplicationServer:atl-cs-001.litwareinc.com удаляются все очереди группы ответа, свойству OverflowCandidate которых присвоено значение NewestCall. Для этого сначала вызывается командлет Get-CsRgsQueue , который возвращает коллекцию из всех очередей группы ответа в службе ApplicationServer:atl-cs-001.litwareinc.com. Эта коллекция передается по конвейеру в командлет Where-Object , выбирающий только очереди, свойству OverflowCandidate которых присвоено значение "NewestCall". Отфильтрованная коллекция передается по конвейеру в командлет Remove-CsRgsQueue , который удаляет все входящие в нее очереди.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"} | Remove-CsRgsQueue

Вызов, поступающий на номер телефона, который связан с "Группа ответа", обычно перенаправляется к вопросу, на который абоненту необходимо дать ответ (например, "Нажмите 1 для поддержки по вопросам оборудования. Нажмите 2 для поддержки по вопросам программного обеспечения"), или помещается в очередь до тех пор, пока не освободится агент группы ответа, который сможет ответить на него.

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

Очереди можно создавать и удалять (для этого используется командлет Remove-CsRgsQueue ). По умолчанию при попытке удалить очередь, назначенную активному рабочему процессу, воспроизводится запрос на подтверждение. В этом случае работа Windows PowerShell приостанавливается, и очереди не удаляются до тех пор, пока не будет получен ответ на запрос. Чтобы обойти эту подсказку и удалить очередь, даже если она назначена активному рабочему процессу, без подтверждения, добавьте параметр Force. Например:

Get-CsRgsQueue –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsQueue –Force

Перед удалением очереди командлет Remove-CsRgsQueue всегда проверяет, используется ли она активным рабочим процессом. Тем не менее, этот командлет не проверяет, используется ли она другой очередью, например, очередью превышения времени ожидания или переполнения. Это означает, что возможно удаление очереди, которая используется другой очередью. В связи с этим, рекомендуется использовать командлет Get-CsRgsQueue , который проверяет значения свойств OverflowAction и TimeoutAction очередей группы ответа, прежде чем удалить очередь с помощью командлета Remove-CsRgsQueue .

 

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

Instance

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

Microsoft.Rtc.Rgs.Management.WritableSettings.Queue

Ссылка на объект, указывающая на удаляемую очередь. При передаче объектов рабочего процесса по конвейеру в командлет Remove-CsRgsQueue можно опустить параметр Instance.

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

$x = Get-CsRgsQueue -Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83

Remove-CsRgsQueue -Instance $x

Обратите внимание, что при использовании параметра Instance можно удалять только по одной очереди за раз. Это значит, что ссылка на объект ($x) не может содержать несколько объектов очереди.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Задает принудительное удаление очереди группы ответа. Если указан этот параметр, очередь удаляется без предупреждения, даже если она используется в активном рабочем процессе. В противном случае перед удалением очереди, используемой активным рабочим процессом, воспроизводится запрос на подтверждение.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

Командлет Remove-CsRgsQueue удаляет существующие экземпляры объекта Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.

 
Показ: