Set-CsRgsConfiguration
Ultima modifica dell'argomento: 2012-03-23
Modifica le impostazioni di configurazione per l'applicazione Response Group.
Sintassi
Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-Confirm [<SwitchParameter>]] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsRgsConfiguration -Instance <ServiceSettings> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
L'applicazione Response Group consente di instradare automaticamente le chiamate telefoniche a entità come il supporto tecnico o la linea del servizio clienti. Quando qualcuno chiama un numero di telefono designato, la chiamata può essere instradata automaticamente all'insieme appropriato di agenti di Response Group. In alternativa, la chiamata può essere instradata a una coda del sistema IVR (Interactive Voice Response). In questa coda potrebbe essere posta una serie di domande (ad esempio, "Sta chiamando per un ordine in corso?") e quindi il chiamante, in base alle risposte date, potrebbe ottenere le informazioni desiderate o essere instradato a un agente di Response Group.
Il cmdlet Set-CsRgsConfiguration consente di modificare le proprietà di un'istanza dell'applicazione Response Group.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsRgsConfiguration 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 "Set-CsRgsConfiguration"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Identità Rgs |
Nome del servizio che ospita le impostazioni di configurazione di Response Group. Ad esempio: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Instance |
Facoltativo |
Oggetto ServiceSettings |
Riferimento oggetto per le impostazioni di configurazione di Response Group Service da modificare. Un riferimento oggetto in genere viene recuperato utilizzando il cmdlet Get-CsRgsConfiguration e assegnando il valore restituito a una variabile. Questo comando ad esempio restituisce un riferimento oggetto alle impostazioni di configurazione trovate nel servizio ApplicationServer:atl-cs-001.litwareinc.com e archivia tale riferimento in una variabile denominata $x: $x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com |
AgentRingbackGracePeriod |
Facoltativo |
Numero intero |
Se un agente rifiuta una chiamata, l'AgentRingbackGracePeriod rappresenta il tempo (in secondi) che deve trascorrere prima che la chiamata ritorni allo stesso agente. Il periodo di tolleranza può essere impostato su un valore intero tra 30 e 600 secondi (10 minuti) inclusi. Il valore predefinito è 60 secondi. |
DefaultMusicOnHoldFile |
Facoltativo |
Oggetto AudioFile |
Rappresenta la musica che, per impostazione predefinita, sarà riprodotta ogni volta che il chiamante sarà lasciato in attesa. La musica predefinita viene riprodotta se un flusso di lavoro di Response Group non ha definito una musica specifica per l'attesa. La proprietà DefaultMusicOnHoldFile deve essere configurata utilizzando un riferimento oggetto creato mediante il cmdlet Import-CsRgsAudioFile. Se DefaultMusicOnHold è uguale a un valore Null (valore predefinito) e per un flusso di lavoro non è definita una musica di attesa personalizzata, ogni volta che un chiamate viene lasciato in attesa, verrà riprodotta la musica di attesa predefinita configurata automaticamente durante l'installazione di Lync Server. |
DisableCallContext |
Facoltativo |
Parametro opzionale |
Se questo parametro è impostato su False (valore predefinito), ciascun agente sarà in grado di vedere il contesto chiamata (informazioni come ad esempio il tempo di attesa del chiamante o le domande e le risposte del flusso di lavoro) ogni volta che viene ricevuta una chiamata. Queste informazioni sono visibili dall'interno di Microsoft Lync 2010. Se impostato su True, le informazioni sul contesto chiamata non vengono trasmesse agli agenti quando viene ricevuta una chiamata. Il contesto della chiamata viene utilizzato solo con le code del sistema IVR. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
WhatIf |
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.ServiceSettings. Set-CsRgsConfiguration accetta le istanze da pipeline dell'oggetto impostazioni dell'applicazione Response Group.
Tipi restituiti
Set-CsRgsConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece istanze esistenti dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30
Il comando mostrato nell'esempio 1 modifica la proprietà AgentRingbackGracePeriod per le impostazioni di configurazione dell'applicazione Response Group trovate nel servizio ApplicationServer:atl-cs-001.litwareinc.com. In questo esempio, AgentRingbackGracePeriod è impostato su 30 secondi.
-------------------------- Esempio 2 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}
Nell'esempio 2 viene modificato il valore AgentRingbackGracePeriod per tutte le impostazioni di configurazione di Response Group presenti nell'organizzazione. A tale scopo, nel comando vengono innanzitutto utilizzati il cmdlet Get-CsService e il parametro ApplicationServer per restituire le informazioni relative a tutti i computer dell'organizzazione in cui è in esecuzione il Servizio applicazione. La raccolta restituita viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i computer la cui proprietà Applications contiene l'applicazione "urn:application:RGS". Tale valore indica che l'applicazione Response Group è in esecuzione nel server.
Tali computer vengono quindi inviati tramite pipe al cmdlet ForEach-Object. ForEach-Object individua i singoli computer della raccolta e utilizza Set-CsRgsConfiguration per impostare su 30 secondi il parametro AgentRingbackGracePeriod delle impostazioni di configurazione di Response Group del computer.
-------------------------- Esempio 3 ------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x
I comandi mostrati nell'esempio 3 importano un file audio (C:\Media\WhileYouWait.wav) e quindi assegnano il file alla proprietà DefaultMusicOnHoldFile. Per eseguire questa attività, nel primo comando viene utilizzato Import-CsRgsAudioFile per importare il file audio nell'applicazione Response Group trovata in ApplicationServer:atl-cs-001.litwareinc.com. Oltre al parametro Identity (che specifica la posizione del servizio), viene utilizzato il parametro FileName per specificare il nome del file da importare.
Ugualmente importante è il parametro Content, che viene utilizzato per importare il file audio. L'importazione di file viene eseguita chiamando il cmdlet Get-Content seguito dal percorso del file da importare. Get-Content richiede inoltre di impostare il tipo di codifica su byte e ReadCount su 0. L'impostazione di ReadCount su 0 garantisce che l'intero file venga letto in una singola operazione. Il file importato viene quindi archiviato in una variabile denominata $x.
Una volta importato il file, viene chiamato Set-CsRgsConfiguration per impostare la proprietà DefaultMusicOnHold sul file audio archiviato in $x.