Condividi tramite


New-CsCpsConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Crea una nuova raccolta di impostazioni del servizio di parcheggio di chiamata, che consente a un utente di "parcheggiare" una chiamata in arrivo. Questo servizio consente di trasferire la chiamata a un numero in un intervallo specificato, o orbit, e di mettere immediatamente la chiamata in attesa. Chiunque (non solo la persona che ha in origine risposto alla chiamata) può riprendere la conversazione da qualsiasi telefono immettendo il numero corretto.

Sintassi

New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet è utilizzato per creare una nuova configurazione del servizio di parcheggio di chiamata. Quando viene installato il servizio di parcheggio di chiamata, per impostazione predefinita vengono configurate le impostazioni globali, che possono essere aggiornate ma non rimosse. (La "rimozione" delle impostazioni globali ripristina semplicemente i valori predefiniti). Pertanto, questo cmdlet è utilizzato per creare solamente impostazioni specifiche per il sito.

In una configurazione di questo servizio viene specificato quanto accade a una chiamata quando viene parcheggiata. Se ad esempio non si risponde a una chiamata parcheggiata entro un determinato periodo di tempo, la chiamata può essere automaticamente inoltrata a un'altra persona, quale un amministratore o un Response Group. Le chiamate possono essere configurate in modo da far squillare il telefono dopo un determinato periodo, affinché la chiamata non venga dimenticata. Il servizio di parcheggio di chiamata può inoltre essere configurato per riprodurre una musica di attesa per il chiamante mentre la chiamata risulta parcheggiata.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsCpsConfiguration 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-CsCpsConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Il sito su cui vengono applicate queste impostazioni. Il sito deve essere immesso nel formato site:<nomesito>, ad esempio site:Redmond. Sarà sempre presente una configurazione nell'ambito globale che non può essere rimossa. Non è possibile pertanto ricreare una configurazione globale con questo cmdlet.

CallPickupTimeoutThreshold

Facoltativo

TimeSpan

L'intervallo di tempo trascorso dopo il parcheggio di una chiamata prima che squilli nuovamente il telefono su cui si è risposto alla chiamata.

Il tempo deve essere immesso nel formato hh:mm:ss (hh = ore, mm = minuti, ss = secondi)

Valore predefinito: 00:01:30 (90 secondi); Valore minimo: 10 secondi (00:00:10); Valore massimo: 10 minuti (00:10:00)

EnableMusicOnHold

Facoltativo

Booleano

Consente di determinare se viene riprodotta della musica per il chiamante mentre una chiamata è parcheggiata.

Microsoft Lync Server 2010 è fornito con un file della musica di attesa predefinito. Per modificare questo file e, di conseguenza, cambiare la musica che il chiamante ascolta durante il parcheggio chiamata, è possibile utilizzare il cmdlet Set-CsCallParkServiceMusicOnHoldFile.

Valore predefinito: True

MaxCallPickupAttempts

Facoltativo

Int32

Il numero di volte che il telefono utilizzato per rispondere a una chiamata successivamente parcheggiata deve squillare prima che la chiamata venga inoltrata all'URI (Uniform Resource Identifier) di fallback. L'URI di fallback viene impostato con il parametro OnTimeoutURI.

Valore predefinito: 1; Valore minimo: 1; Valore massimo: 10

OnTimeoutURI

Facoltativo

Stringa

L'indirizzo SIP dell'utente o del gruppo di risposta a cui saranno instradate le chiamate parcheggiate senza risposta. La chiamata parcheggiata sarà instradata dopo il numero di richiamate automatiche definito nel parametro MaxCallPickupAttempts. Se il parametro è impostato su NULL, il parametro OnTimeoutURI verrà ignorato e la chiamata parcheggiata verrà disconnessa dopo i tentativi di richiamata non riusciti.

I valori devono essere URI SIP che iniziano con la stringa sip:, ad esempio, sip:rgs1@litwareinc.com.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

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.

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

Nessuno.

Tipi restituiti

Questo cmdlet crea un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Esempio

-------------------------- Esempio 1 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

Nel comando riportato nell'esempio 1 viene utilizzato il cmdlet New-CsCpsConfiguration per creare una configurazione del servizio di parcheggio di chiamata per il sito Redmond1. Questa configurazione verrà creata con i valori predefiniti, ad eccezione di EnableMusicOnHold. Il comando imposta questa proprietà su False, per cui il chiamante la cui chiamata è stata parcheggiata non ascolterà alcuna musica durante l'attesa. Il valore di EnableMusicOnHold è True per impostazione predefinita, presupponendo che sia stato distribuito il servizio di parcheggio di chiamata.

-------------------------- Esempio 2 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

Nel comando riportato nell'esempio 2 viene utilizzato il cmdlet New-CsCpsConfiguration per creare una configurazione del servizio di parcheggio di chiamata per il sito Redmond1. Per impostazione predefinita nessun valore OnTimeoutURI viene fornito per cui questo esempio aggiunge un valore per questo parametro. In questo caso, il parametro OnTimeoutURI è impostato su sip:davidegarghentini@litwareinc.com. Il valore passato a questo parametro deve iniziare con la stringa "sip:" e puntare a un utente o a un Response Group che riceverà le chiamate parcheggiate che non ricevono risposta dopo un numero specificato di tentativi di richiamata.

-------------------------- Esempio 3 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Nel comando viene utilizzato il cmdlet New-CsCpsConfiguration per creare una configurazione del servizio di parcheggio di chiamata per il sito Redmond1. Per questo sito, MaxCallPickupAttempts è stato impostato su 2. Ciò significa che la chiamata squillerà due volte.