Condividi tramite

  • Articolo

Set-CsCpsConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare una raccolta di impostazioni del servizio Parcheggio di chiamata. Parcheggio di chiamata è un servizio che consente a un utente di "parcheggiare" una chiamata telefonica in arrivo. Parcheggiare una chiamata significa trasferirla ad un numero in uno specifico intervallo, o orbit, e immediatamente metterla 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

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

Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di modificare la configurazione di un servizio Parcheggio di chiamata esistente. La configurazione di un servizio Parcheggio di chiamata indica cosa succede a una chiamata quando viene parcheggiata. Ad esempio, se non si risponde a una chiamata parcheggiata entro un determinato periodo, la chiamata può essere automaticamente inoltrata a un'altra persona, ad esempio un amministratore, o a un gruppo di risposta. Le chiamate possono essere configurate in modo da far squillare il telefono dopo un determinato periodo, affinché la chiamata non venga dimenticata. Inoltre, il servizio Parcheggio di chiamata può essere configurato per riprodurre una musica di attesa per il chiamante mentre la chiamata risulta parcheggiata.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsCpsConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCpsConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Un identificatore univoco della configurazione da modificare. Identity specifica l'ambito di applicazione della configurazione, vale a dire Global o un sito specifico (nel formato site:<nomeSito>, ad esempio site:Redmond).

Instance

Facoltativo

CallParkServiceSettings

Un riferimento a un oggetto di configurazione del servizio Parcheggio di chiamata di tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Per recuperare questo oggetto, utilizzare il cmdlet Get-CsCpsConfiguration. L'oggetto può quindi essere modificato e le modifiche possono essere salvate inviando di nuovo l'oggetto al cmdlet Set-CsCpsConfiguration in questo parametro.

CallPickupTimeoutThreshold

Facoltativo

Durata

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 in formato hh:mm:ss (hh = ore, mm = minuti, ss = secondi)

Valore minimo: 10 secondi (00:00:10); Valore massimo: 10 minuti (00:10:00)

EnableMusicOnHold

Facoltativo

Booleano

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

Microsoft Lync Server 2010 è fornito con un file predefinito per la musica di attesa. Per modificare questo file (e cambiare quindi la musica ascoltata dal chiamante durante il parcheggio) è possibile utilizzare il cmdlet Set-CsCallParkServiceMusicOnHoldFile.

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 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 questo parametro viene impostato su Null, OnTimeoutURI verrà ignorato e la chiamata parcheggiata verrà disconnessa dopo un tentativo di richiamata non riuscito.

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

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Accetta input tramite pipeline da oggetti configurazione del servizio Parcheggio di chiamata.

Tipi restituiti

Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Esempio

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

Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Il comando riportato nell'Esempio 1 consente di modificare la configurazione del servizio Parcheggio di chiamata con Identity site:Redmond1 impostando su 2 il numero massimo di volte che una chiamata parcheggiata può far squillare il telefono che risponde. Per ottenere questo risultato, viene incluso il parametro MaxCallPickupAttempts e il suo valore viene impostato su 2.

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

Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2

Il comando riportato nell'Esempio 2 è una variante del comando riportato nell'Esempio 1; in questo caso, però, per tutte le configurazioni del servizio Parcheggio di chiamata, il valore della proprietà MaxCallPickupAttempts viene impostato su 2. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsCpsConfiguration per ottenere una raccolta di tutte le impostazioni del servizio Parcheggio di chiamata in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Set-CsCpsConfiguration che imposta il valore 2 per la proprietà MaxCallPickupAttempts di ogni singolo elemento nella raccolta.

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

Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45

In questo esempio, la configurazione del servizio Parcheggio di chiamata per il sito Redmond1 viene modificata impostando su 45 secondi il valore della proprietà CallPickupTimeoutThreshold, cioè l'intervallo di tempo che deve trascorrere prima che una chiamata parcheggiata faccia squillare di nuovo il telefono.