New-CsRgsQueue
Ultima modifica dell'argomento: 2012-03-23
Crea una nuova coda di Response Group. Con l'applicazione Response Group, le chiamate telefoniche vengono inserite in una coda e i chiamanti vengono lasciati in attesa finché un agente di Response Group non è disponibile per rispondere alla chiamata.
Sintassi
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Quando qualcuno chiama un numero di telefono associato all'applicazione Response Group, in genere avviene quanto segue: la chiamata viene trasferita a una domanda a cui il chiamante deve rispondere per continuare (ad esempio, "Premere 1 per supporto hardware; premere 2 per supporto software") oppure viene messa in coda finché l'agente non è disponibile per rispondere.
Invece di avere una singola coda per tutte le chiamate telefoniche, l'applicazione Response Group consente di creare più code che è possibile associare a flussi di lavoro e gruppi di agenti di Response Group diversi. Questo significa che le code possono rispondere diversamente a eventi come ad esempio un determinato numero di chiamate da mettere in coda contemporaneamente o chiamanti lasciati in attesa per un determinato intervallo di tempo.
Il cmdlet New-CsRgsQueue consente agli amministratori di creare facilmente nuove code di Reponse Group.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsRgsQueue i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsQueue"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Parent |
Obbligatorio |
Identità Rgs |
Servizio in cui sarà ospitata la nuova coda. Ad esempio: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Name |
Obbligatorio |
Stringa |
Nome univoco da assegnare alla coda. La combinazione della proprietà Parent e della proprietà Name consente di identificare in modo univoco le code di Response Group senza dover fare riferimento al relativo identificatore univoco globale (GUID). |
AgentGroupIdList |
Facoltativo |
Raccolta AgentGroup |
Identità dei gruppi di agenti di Response Group da aggiungere alla coda. Le identità dei gruppi di agenti possono essere recuperate utilizzando il cmdlet Get-CsRgsAgentGroup. Per informazioni dettagliate, vedere la sezione relativa agli esempi in questo argomento. Se una chiamata viene instradata a una coda a cui non è assegnato alcun gruppo di agenti o a cui sono assegnati gruppi di agenti vuoti, la chiamata verrà disconnessa automaticamente. |
Description |
Facoltativo |
Stringa |
Consente agli amministratori di fornire informazioni aggiuntive sulla coda di Response Group. |
OverflowAction |
Facoltativo |
Oggetto CallAction |
Azione da eseguire se viene raggiunta la soglia di overflow. L'oggetto OverflowAction deve essere creato utilizzando il cmdlet New-CsRgsCallAction. |
OverflowCandidate |
Facoltativo |
Modificatore elenco PS |
Indica su quale chiamata agire quando si raggiunge la soglia di overflow. La proprietà OverflowCandidate deve essere impostata su uno dei seguenti valori: NewestCall OldestCall Il valore predefinito è NewestCall. |
OverflowThreshold |
Facoltativo |
Numero intero |
Numero di chiamate simultanee che possono restare in coda prima che venga attivata l'azione di overflow. L'OverflowThreshold può essere un valore intero compreso tra 0 e 1000 inclusi. Il valore predefinito è NULL, il che significa che in una coda può essere presente simultaneamente un numero illimitato di chiamate. |
TimeoutAction |
Facoltativo |
Oggetto CallAction |
Azione da eseguire se viene raggiunta la soglia di timeout. L'oggetto TimeoutAction deve essere creato utilizzando il cmdlet New-CsRgsCallAction. |
TimeoutThreshold |
Facoltativo |
Numero intero |
Quantità di tempo (in secondi) durante la quale una chiamata può restare nella coda prima che si verifichi il relativo timeout. A questo punto, il sistema eseguirà l'azione specificata dal parametro TimeoutAction. La soglia di timeout può essere un valore intero compreso tra 10 e 65535 secondi (circa 18 ore) inclusi; il valore predefinito è NULL, il che significa che non c'è timeout relativo alla chiamata. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
Tipi di input
Nessuno. New-CsRgsQueue non accetta l'input da pipeline.
Tipi restituiti
New-CsRgsQueue crea nuove istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Esempio
-------------------------- Esempio 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
L'esempio 1 crea una nuova coda di Response Group per il servizio ApplicationServer:atl-cs-001.litwareinc.com. Nel primo comando dell'esempio viene utilizzato il cmdlet New-CsRgsCallAction per creare un'azione di chiamata per la coda. In questo esempio, ogni volta che viene superata la soglia di overflow, le chiamate vengono trasferite automaticamente alla segreteria telefonica. Questa condizione viene configurata impostando il parametro Action su TransferToVoicemailUri e la proprietà URI sull'URI SIP della segreteria telefonica "sip:+14255551298@litwareinc.com".
Una volta che l'azione di chiamata è stata configurata e archiviata nella variabile $x, viene quindi utilizzato New-CsRgsQueue per creare una nuova coda denominata Help Desk. Oltre a specificare l'oggetto OverflowAction, questo comando configura i valori per le proprietà OverflowCandidate e OverflowThreshold.