Set-CsRgsConfiguration

Skype for Business Server 2015
 

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

Изменяет параметры конфигурации для приложения "Группа ответа". Данный командлет впервые появился в Lync Server 2010.

Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] <COMMON PARAMETERS>
Set-CsRgsConfiguration -Instance <ServiceSettings> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 показана команда, позволяющая изменить свойство AgentRingbackGracePeriod в параметрах конфигурации "Группа ответа", которое размещается в службе ApplicationServer:atl-cs-001.litwareinc.com. В этом примере свойству AgentRingbackGracePeriod присваивается значение, равное 30 секундам.

Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30

В примере 2 изменяется значение свойства AgentRingbackGracePeriod в параметрах конфигурации всех групп ответа в организации. Для этого сначала вызывается командлет Get-CsService с параметром ApplicationServer, который возвращает сведения обо всех компьютерах с приложения в организации. Возвращаемая коллекция передается по конвейеру в командлет Where-Object , который выбирает только те компьютеры, свойство Applications которых содержит значение "urn:application:RGS" (свидетельствует о том, что на сервере выполняется "Группа ответа").

Выбранные компьютеры передаются по конвейеру в командлет ForEach-Object . Для каждого компьютера в коллекции командлет ForEach-Object с помощью командлета Set-CsRgsConfiguration поочередно присваивает свойству AgentRingbackGracePeriod в параметрах конфигурации группы ответа значение, равное 30 секундам.

Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}

В примере 3 показаны команды, позволяющие импортировать звуковой файл C:\Media\WhileYouWait.wav и привязать его к свойству DefaultMusicOnHoldFile. Для этого сначала вызывается командлет Import-CsRgsAudioFile , который импортирует звуковой файл в систему "Группа ответа", размещаемую в службе ApplicationServer:atl-cs-001.litwareinc.com. Помимо параметра Identity, который задает расположение службы, используется параметр FileName, определяющий имя импортируемого файла.

Также при импорте звукового файла важно использовать параметр Content. Для импорта вызывается командлет Get-Content , в котором указывается импортируемый файл. В командлете Get-Content также необходимо задать тип кодировки byte и значение параметра ReadCount, равное 0 (это значение позволяет считывать файл целиком за одну операцию). Импортируемый файл сохраняется в переменной $x.

После импорта файла вызывается командлет Set-CsRgsConfiguration , который устанавливает свойство DefaultMusicOnHoldFile звукового файла, хранящегося в переменной $x.

$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)

Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x

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

Командлет Set-CsRgsConfiguration позволяет изменять свойства экземпляра "Группа ответа".

 

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

Identity

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

Microsoft.Rtc.Rgs.Management.RgsIdentity

Имя службы, в которой размещаются параметры конфигурации группы ответа. Например, -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com.".

Instance

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

Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings

Ссылка на объект параметров конфигурации для группы ответа, который требуется изменить. Для извлечение ссылки на объект обычно используется командлет Get-CsRgsConfiguration , возвращаемое которым значение присваивается переменной. Например, следующая команда возвращает ссылку на объект параметров конфигурации в службе ApplicationServer:atl-cs-001.litwareinc.com и сохраняет ее в переменной $x:

$x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com

AgentRingbackGracePeriod

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

System.Int16

Параметр AgentRingbackGracePeriod определяет период времени в секундах, по истечении которого вызов может быть возвращен агенту, который ранее отклонил его. Величина льготного периода может колебаться от 30 до 600 секунд (10 минут) включительно. Значение по умолчанию — 60 секунд.

Confirm

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

System.Management.Automation.SwitchParameter

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

DefaultMusicOnHoldFile

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

Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile

Музыкальное сопровождение, которое по умолчанию слышат абоненты в режиме удержания (воспроизводится только в том случае, если в рабочем процессе группы ответа не определено настраиваемое музыкальное сопровождение).

Для настройки свойства DefaultMusicOnHoldFile необходимо использовать ссылку на объект, созданную с помощью командлета Import-CsRgsAudioFile .

Если свойство DefaultMusicOnHold имеет значение null (по умолчанию), и в рабочем процессе не определено настраиваемое музыкальное сопровождение для режима удержания, в соответствующих случаях будет воспроизводиться музыка, заданная по умолчанию при установке Skype для бизнеса Server 2015.

DisableCallContext

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

System.Boolean

Если имеет значение False (по умолчанию), все агенты могут просматривать контекст поступающего вызова (сведения о времени ожидания абонента или рабочий процесс с вопросами и ответами). Эти сведения отображаются в Skype для бизнеса. Если имеет значение True, данные контекста не передаются вместе с поступающим вызовом.

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

Force

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: