Get-CsRgsQueue
Ultima modifica dell'argomento: 2012-03-23
Recupera informazioni relative alle code di Response Group in uso nell'organizzazione. Con l'applicazione Response Group, le chiamate telefoniche vengono inserite in una coda e lasciate in attesa finché un agente di Response Group non è disponibile per rispondere.
Sintassi
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
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 proseguire (ad esempio, "Premere 1 per supporto hardware; premere 2 per supporto software") oppure viene messa in coda finché un agente di Response Group 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 numero di secondi.
Il cmdlet Get-CsRgsQueue consente di restituire informazioni sulle code di Response Group configurate per l'utilizzo nell'organizzazione.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsRgsQueue i membri dei seguenti gruppi: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsRgsQueue"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità Rgs |
Rappresenta l'identità del servizio in cui è ospitata la coda di Response Group o l'identità piena della stessa coda. Se si specifica l'identità del servizio (ad esempio, service:ApplicationServer:atl-cs-001.litwareinc.com), verranno restituite tutte le code di Response Group ospitate nel servizio. Se si specifica l'identità della coda, verrà restituita solo la coda di Response Group specificata. L'identità di una coda è costituita dall'identità del servizio seguita da un identificatore univoco globale (GUID), ad esempio service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. Un modo alternativo per restituire una singola coda di Response Group consiste nello specificare l'identità del servizio e nell'includere il parametro Name e il nome della coda. Ciò consente di recuperare una coda specifica senza conoscere il GUID assegnato alla coda stessa. Se chiamato senza alcun parametro, Get-CsRgsQueue restituisce tutte le code di Response Group configurate per l'utilizzo nell'organizzazione. |
Name |
Facoltativo |
Stringa |
Nome univoco assegnato alla coda di Response Group nel momento stesso in cui la coda è stata creata. |
Tipi di input
Stringa. Get-CsRgsQueue accetta un valore stringa che rappresenta l'identità della coda di Response Group.
Tipi restituiti
Get-CsRgsQueue restituisce istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
Il comando precedente restituisce informazioni su tutte le code di Response Group configurate per l'utilizzo nell'organizzazione. A tale scopo, viene chiamato Get-CsRgsQueue senza alcun parametro.
-------------------------- Esempio 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
Il comando mostrato nell'esempio 2 restituisce informazioni su tutte le code di Response Group trovate nel servizio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Esempio 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
Nell'esempio 3 vengono restituite informazioni per una singola coda di Response Group, ovvero la coda denominata "Help Desk", trovata nel servizio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Esempio 4 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
Il comando mostrato nell'esempio 4 visualizza informazioni dettagliate sulla proprietà TimeoutAction di ciascuna coda di Response Group trovata nel servizio ApplicationServer:atl-cs-001.litwareinc.com. Per eseguire questa attività, viene innanzitutto utilizzato Get-CsRgsQueue per restituire informazioni su tutte le code trovate in ApplicationServer:atl-cs-001.litwareinc.com. Le informazioni vengono quindi passate al cmdlet Select-Object, che espande il valore archiviato nella proprietà TimeoutAction. Quando si espande la proprietà TimeoutAction, sono visibili le singole proprietà dell'oggetto incorporato che costituiscono il valore della proprietà, ovvero Prompt; TargetQuestion; Target; TargetQueueID; e TargetUri.
-------------------------- Esempio 5 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
Il comando precedente restituisce informazioni su tutte le code di Response Group in ApplicationServer:atl-cs-001.litwareinc.com la cui proprietà OverflowCandidate è impostata su NewestCall. Per eseguire questa attività, nel comando viene innanzitutto utilizzato Get-CsRgsQueue per restituire una raccolta di tutte le code di Response Group trovate nel servizio specificato. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le code in cui la proprietà OverflowCandidate è uguale a "NewestCall".