Set-CsSlaConfiguration

Skype for Business Server 2015
 

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

Use the Set-CsSlaConfiguration cmdlet to create or modify a shared number in Shared Line Appearance (SLA). A shared number in SLA is an Enterprise Voice user that is capable of receiving multiple calls at a time and forwarding them to its delegates, who answer the call.

Set-CsSlaConfiguration -Identity <UserIdParameter> [-BusyOption <Forward | BusyOnBusy | Voicemail>] [-Confirm [<SwitchParameter>]] [-MaxNumberOfCalls <UInt32>] [-MissedCallForwardTarget <Uri>] [-MissedCallOption <Disconnect | Forward | BusySignal>] [-PassThru <SwitchParameter>] [-Target <Uri>] [-WhatIf [<SwitchParameter>]]

This example configures SLA for a user identified as “emergency” that can accept at max 3 calls at a time. Note that “emergency” is a valid enterprise voice enabled Skype for Business (SfB) user. BusyOption is required if SLA is being setup for the first time.

Set-CsSlaConfiguration -Identity emergency -MaxNumberOfCalls 3 -BusyOption BusyOnBusy

This example configures SLA for a user identified as “emergency” to forward calls to “sla_forward_number” when all lines are busy.

Set-CsSlaConfiguration -Identity emergency -MaxNumberOfCalls 3 -BusyOption Forward -Target sip:sla_forward_number@contosohealth.com  

This example configures SLA for a user identified as “emergency” to transfer to voice mail when all lines are busy.

Set-CsSlaConfiguration -Identity emergency -MaxNumberOfCalls 3 -BusyOption Voicemail

SLA is a feature in Skype for Business (SfB) for handling multiple calls on a specific number called a shared number. SLA can configure any enterprise voice enabled SfB user as a shared number with multiple lines to respond to multiple calls. The calls are not actually received on the shared number, instead they are forwarded to users that act as delegates for the shared number. Any one of the delegates can pick up the call while the rest of the delegates get a notification on their phone about who picked up the call and which line has become busy as a result. Both the number of lines and the delegates are configurable for a shared number in SLA. In addition, advanced options such as BusyOption (what happens in a situation when all lines are busy) and MissedCallOption (the case in which none of the delegates pick up a call) etc. can also be configured for a shared number.

The Set-CsSlaConfiguration cmdlet provides a way to configure a shared number.

noteПримечание.
Logging in with the account created for the SLA number is not supported. Using the SLA number account with any device or Desktop Client can result in unpredictable behavior. It is not necessary to use that account for the Shared Line Appearance feature to function.

By default, members of the RTCUniversalServerAdmins group are authorized to run the Set-CsSlaConfiguration cmdlet. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsSlaConfiguration"}

 

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.AD.UserIdParameter

Indicates the identity of the Enterprise Voice user whose shared number information will be created or modified.

Идентификаторы пользователей могут быть заданы в одном из пяти форматов.

  • Адрес SIP

    Пример: sip:kenmyer@litwareinc.com

  • Имя субъекта-пользователя (UPN)

    Пример: kenmyer@litwareinc.com

  • Имя домена и имя входа в форме "домен\имя_для_входа"

    Пример: litwareinc\kenmyer

  • Отображаемое имя Active Directory (как правило, в этом формате необходимы кавычки)

    Пример: "Ken Myer"

  • Различающееся имя Active Directory

    Пример: CN=KenMyer,CN=Users,DC=Atlanta,DC=Corp,DC=litware,DC=com

BusyOption

Optional

Microsoft.Rtc.Management.SlaBusyOption

Specifies the action to take when all lines are busy. The valid values for the option are “Forward”, ”BusyOnBusy”, or “Voicemail”. The default is “BusyOnBusy”.

Confirm

Optional

System.Management.Automation.SwitchParameter

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

MaxNumberOfCalls

Optional

System.UInt32

Specifies the maximum number of calls the shared number can receive.

MissedCallForwardTarget

Optional

System.Uri

Specifies the forwarding target if MissedCallOption is set to “Forward”. MissedCallForwardTarget should be set to a valid SIP Uri. If the PSTN number needs to be specified, it should be prefixed with “tel:”. For example, “tel:+2504395”.

MissedCallOption

Optional

Microsoft.Rtc.Management.SlaUserMissedCallOption

Specifies the action to take when none of the delegates picks up the call. The valid values for the option are “Disconnect”, “Forward”, or “BusySignal”. The default is “Disconnect”.

PassThru

Optional

System.Management.Automation.SwitchParameter

При наличии данного ключа -PassThru командлет передает текущие объекты по конвейеру.

Target

Optional

System.Uri

Specifies the forwarding target if BusyOption is set to “Forward”. Target should be set to a valid SIP Uri. If the PSTN number needs to be specified, it should be prefixed with “tel:”, “tel:+2504395”.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

The Set-CsSlaConfiguration cmdlet accepts a pipelined object representing a user account that has been enabled for Skype для бизнеса Server 2015.

The Set-CsSlaConfiguration cmdlet returns an instance of the Microsoft.Rtc.Management.SlaConfiguration object.

 
Показ: