Set-CsHuntGroup

 

上次修改主題的時間:2017-06-20

Use the New-CsHuntGroup cmdlet to modify a call queue.

Set-CsHuntGroup -PrimaryUri <Uri> [-AgentAlertTime <Int16>] [-AllowOptOut <$true | $false>] [-ClientAudience <String>] [-Confirm [<SwitchParameter>]] [-DistributionLists <List>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-HuntGroupServiceCallbackUri <Uri>] [-LineUri <Uri>] [-MusicOnHoldFileContent <Byte[]>] [-MusicOnHoldFileName <String>] [-Name <String>] [-OverflowAction <DisconnectWithBusy | Forward | Voicemail>] [-OverflowActionTarget <Uri>] [-OverflowThreshold <Int16>] [-RoutingMethod <Attendant | Serial>] [-Tenant <Guid>] [-TimeoutAction <Disconnect | Forward | Voicemail>] [-TimeoutActionTarget <Uri>] [-TimeoutThreshold <Int16>] [-UseDefaultMusicOnHold <$true | $false>] [-WelcomeMusicFileContent <Byte[]>] [-WelcomeMusicFileName <String>] [-WhatIf [<SwitchParameter>]]

This example sets the call queue "helpdesk@litwareinc.com" to be named "Contoso helpdesk2." If the call remains unanswered for 60 seconds, it is routed to another agent. Associated distribution lists are DistList3 and DistList4. If the call times out after 5 minutes, it is forwarded.

Set-CsHuntGroup -PrimaryUri "sip:helpdesk@litwareinc.com" -Name "Contoso helpdesk2" -AgentAlertTime 60 -DistributionLists "DistList3", "DistList4" -TimeoutAction Forward -TimeoutActionTarget "tel:+12345678" -TimeoutThreshold 5 

The Set-CsHuntGroup cmdlet lets you modify the properties of an existing call queue. For example, you can change the phone number for a call queue, the distribution lists associated with a call queue, or the welcome audio file that the call queue uses.

註記注意事項:
If the Set-CsHuntGroup cmdlet changes distribution lists, the membership update might not happen immediately.

 

Parameter Required Type Description

PrimaryUri

Required

System.Uri

The PrimaryUri parameter identifies the SIP address for the call queue. For example: -PrimaryUri "sip:helpdesk@litwareinc.com". The PrimaryUri must begin with the "sip:" prefix.

AgentAlertTime

Optional

System.Int16

The AgentAlertTime parameter represents the time (in seconds) that a call can remain unanswered before it is automatically routed to the next agent. The AgentAlertTime can be set to any integer value between 30 and 180 seconds (3 minutes), inclusive. The default value is 30 seconds.

AllowOptOut

Optional

System.Boolean

PARAMVALUE: $true | $false

ClientAudience

Optional

System.String

PARAMVALUE: String

Confirm

Optional

System.Management.Automation.SwitchParameter

Confirm 參數會導致此命令暫停處理,並需要確認才能進行。

DistributionLists

Optional

System.Collections.Generic.List

The DistributionLists parameter lets you add all the members of the distribution lists (DLs) to the call queue. This is a list of distribution list GUID. A service wide configurable maximum number of DLs per HuntGroup are allowed. Only the first N (service wide configurable) agents from all distribution lists combined are considered for accepting the call. Nested DLs are not supported. If a DL has nested DLs, the parent DL is ignored.

DomainController

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

PARAMVALUE: Fqdn

Force

Optional

System.Management.Automation.SwitchParameter

PARAMVALUE: SwitchParameter

HuntGroupServiceCallbackUri

Optional

System.Uri

PARAMVALUE: Uri

LineUri

Optional

System.Uri

The LineUri parameter is the phone number for the call queue. The line Uniform Resource Identifier (URI) must be specified by using the following format: the TEL: prefix followed by a plus sign, followed by the country/region calling code, area code, and phone number (using only digits: no blank spaces, periods, or hyphens). For example: -LineUri "TEL:+14258828080".

MusicOnHoldFileContent

Optional

System.Byte[]

The MusicOnHoldFileContent parameter represents music to play when callers are placed on hold. This is the content of the audio file. Supported formats are: .wav, .mp3, and .wma. This parameter is required if the UseDefaultMusicOnHold parameter is not specified.

MusicOnHoldFileName

Optional

System.String

The MusicOnHoldFileName parameter represents music to play when callers are placed on hold. This is the name of the audio file. Supported formats are: .wav, .mp3, and .wma. This parameter is required if the UseDefaultMusicOnHold parameter is not specified.

Name

Optional

System.String

The Name parameter identifies a unique name for the call queue.

OverflowAction

Optional

Microsoft.Rtc.Management.Hosted.HuntGroup.Models.OverflowAction

The OverflowAction parameter designates the action to take if the overflow threshold is reached. The OverflowAction property must be set to one of the following three values:

  • DisconnectWithBusy

  • Forward

  • Voicemail

The default value is DisconnectWithBusy.

OverflowActionTarget

Optional

System.Uri

The OverflowActionTarget parameter represents the target of the overflow action. For example, if the OverFlowAction is set to Forward, this parameter might be set to a SIP address or a PSTN phone number.

This parameter is optional unless the OverflowAction is set to Forward, which requires either a SIP address or a PSTN phone number.

OverflowThreshold

Optional

System.Int16

The OverflowThreshold parameter defines the number of simultaneous calls that can be in the queue at any one time before the overflow action is triggered. The OverflowThreshold can be any integer value between 0 and 200, inclusive. The default value is 50. A value of 0 causes the overflow action to be taken immediately.

RoutingMethod

Optional

Microsoft.Rtc.Management.Hosted.HuntGroup.Models.RoutingMethod

PARAMVALUE: Attendant | Serial

Tenant

Optional

System.Guid

PARAMVALUE: Guid

TimeoutAction

Optional

Microsoft.Rtc.Management.Hosted.HuntGroup.Models.TimeoutAction

The TimeoutAction parameter defines the action to take if the timeout threshold is reached. The TimeoutAction property must be set to one of the following three values:

  • Disconnect

  • Forward

  • Voicemail

The default value is Disconnect. In MVP1, the busy tone might not be played before the call is disconnected.

TimeoutActionTarget

Optional

System.Uri

The TimeoutActionTarget represents the target of the timeout action. For example, if the TimeoutAction is set to Forward, this parameter might be set to a SIP address or a PSTN phone number.

This field is optional unless the TimeoutAction is set to Forward, which requires either a SIP address or a PSTN phone number.

TimeoutThreshold

Optional

System.Int16

The TimeoutThreshold parameter defines the time (in minutes) that a call can be in the queue before that call times out. At that point, the system will take the action specified by the TimeoutAction parameter.

The TimeoutThreshold can be any integer value between 0 and 45 minutes, inclusive; the default value is 20 minutes.

UseDefaultMusicOnHold

Optional

System.Boolean

The UseDefaultMusicOnHold parameter indicates that this call queue uses the default music when a call is placed on hold. This parameter cannot be specified together with MusicOnHoldFileName and MusicOnHoldFileContent.

WelcomeMusicFileContent

Optional

System.Byte[]

The WelcomeMusicFileContent parameter represents the audio file to play when callers are connected with the call queue. This is the content of the audio file. Supported formats are: .wav, .mp3, .and .wma.

WelcomeMusicFileName

Optional

System.String

The WelcomeMusicFileName parameter represents audio file to play when callers are connected with the call queue. This is the name to the audio file. Supported formats are: .wav, .mp3, and .wma.

WhatIf

Optional

System.Management.Automation.SwitchParameter

WhatIf 參數會導致此命令模擬其結果。使用此參數,您不需認可變更,就能檢視這些變更。

BypassDualWrite

Optional

System.Boolean

PARAMVALUE: $true | $false

Domain

Optional

System.String

The Domain parameter denotes the domain part of the primary uri for the call queue. This domain name is validated against the list of domains that the tenant owns.

The Set-CsHuntGroup cmdlet returns an updated instance of the Microsoft.Skype.Rgs.Configuration.HuntGroup object.

 
顯示: