Remove-CsRgsAgentGroup
Ultima modifica dell'argomento: 2012-05-21
Rimuove un gruppo di agenti esistente di Response Group. Un gruppo di agenti è una raccolta di agenti assegnati alla coda di Response Group. Gli agenti sono gli utenti designati per rispondere alle chiamate dirette a una coda particolare.
Sintassi
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Quando viene chiamato un numero di telefono associato all'applicazione Response Group, il servizio innanzitutto determina quale flusso di lavoro corrisponde al numero chiamato. A seconda della configurazione del flusso di lavoro, la chiamata può essere instradata a un insieme di domande del sistema IVR (Interactive Voice Response), in cui al chiamante vengono poste una o più domande, ad esempio "La domanda riguarda il supporto hardware o software?". In alternativa, la chiamata può essere inserita in una coda di Response Group, dove il chiamante resterà in attesa finché qualcuno non sarà disponibile per rispondere alla chiamata. Le persone designate a rispondere alle chiamate sono dette agenti, e un gruppo di agenti viene chiamato gruppo di agenti di Response Group. I gruppi di agenti sono associati ai flussi di lavoro, e quindi associati a questo genere di responsabilità; ad esempio, il personale del supporto tecnico può essere raggruppato nel gruppo di agenti Help Desk mentre gli agenti del servizio clienti possono essere raggruppati nel gruppo di agenti Customer Support.
È possibile creare nuovi gruppi di agenti utilizzando il cmdlet New-CsRgsAgentGroup. Per eliminare un gruppo di agenti, è possibile chiamare il cmdlet Remove-CsRgsAgentGroup. Questo cmdlet elimina l'intero gruppo e quindi tutti gli agenti presenti nel gruppo. Se si desidera rimuovere solo un singolo agente da un gruppo, utilizzare invece il cmdlet Set-CsRgsAgentGroup.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsRgsAgentGroup 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 "Remove-CsRgsAgentGroup"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Instance |
Obbligatorio |
Oggetto AgentGroup |
Riferimento all'oggetto che punta al gruppo di agenti da rimuovere. Quando gli oggetti flusso di lavoro vengono inviati tramite pipe a Remove-CsRgsAgentGroup, è possibile omettere il parametro Instance. Per utilizzare il parametro Instance, sono necessari comandi analoghi al seguente: $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x Si noti che è possibile rimuovere un solo gruppo di agenti alla volta quando si utilizza il parametro Instance. Ciò significa che il riferimento all'oggetto ($x) non può contenere più oggetti gruppo di agenti. |
Force |
Facoltativo |
Parametro opzionale |
Forza la rimozione del gruppo di agenti. Se questo parametro è presente, il gruppo di agenti verrà eliminato senza avviso, anche se è utilizzato da un flusso di lavoro attivo. Se questo parametro non è presente, verrà richiesto di confermare l'eliminazione di qualsiasi gruppo di agenti attualmente utilizzato da un flusso di lavoro attivo. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup. Remove-CsRgsAgentGroup accetta le istanze da pipeline dell'oggetto gruppo di agenti di Response Group.
Tipi restituiti
Remove-CsRgsAgentGroup elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
Il comando precedente elimina tutti i gruppi di agenti di Response Group configurati per l'utilizzo nel servizio ApplicationServer:atl-cs-001.litwareinc.com. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsRgsAgentGroup per restituire tutti i gruppi di agenti per ApplicationServer:atl-cs-001.litwareinc.com. Questi gruppi vengono quindi inviati tramite pipe al cmdlet Remove-CsRgsAgentGroup, che li rimuove.
-------------------------- Esempio 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
Nell'esempio 2, viene rimosso un gruppo di agenti di Response Group: il gruppo denominato Help Desk. A tale scopo, viene innanzitutto utilizzato Get-CsRgsAgentGroup per restituire il gruppo di agenti Help Desk (-Name "Help Desk") da ApplicationServer:atl-cs-001.litwareinc.com. Il gruppo viene quindi inviato tramite pipe a Remove-CsRgsAgentGroup, che rimuove il gruppo dal servizio.
-------------------------- Esempio 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
Nell'esempio 3 vengono eliminati tutti i gruppi di agenti di Response Group in ApplicationServer:atl-cs-001.litwareinc.com che non utilizzano il metodo di routing round robin. A tale scopo, viene innanzitutto chiamato Get-CsRgsAgentGroup per restituire una raccolta di tutti i gruppi di agenti trovati nel servizio ApplicationServer:atl-cs-001.litwareinc.com. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i gruppi in cui la proprietà RoutingMethod non è uguale a (-ne) RoundRobin. La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsRgsAgentGroup, che elimina ogni elemento presente nella raccolta.