Condividi tramite

  • Articolo

Set-CsCallParkServiceMusicOnHoldFile

 

Ultima modifica dell'argomento: 2012-03-26

Modifica il file audio riprodotto ai chiamanti in attesa durante una chiamata parcheggiata.

Sintassi

Set-CsCallParkServiceMusicOnHoldFile -Service <String> -Content <Byte[]> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il parcheggio di chiamata è un servizio che consente a un utente di "parcheggiare" una telefonata in arrivo. Il parcheggio trasferisce una chiamata a un numero in un intervallo specificato e lo mette immediatamente in attesa. A seconda delle impostazioni di configurazione del servizio di parcheggio di chiamata, è possibile che mentre la chiamata è parcheggiata il chiamante ascolti una musica di attesa. Utilizzare questo cmdlet per cambiare il file audio (musica di attesa) riprodotto a un chiamante parcheggiato in attesa.

La musica di attesa viene riprodotta solo se la proprietà EnableMusicOnHold del servizio di parcheggio di chiamata è stata impostata su True. Per controllare questa proprietà è possibile chiamare il cmdlet Get-CsCpsConfiguration. La proprietà può essere impostata sia durante la creazione della configurazione di parcheggio di chiamata con New-CsCpsConfiguration sia dopo aver creato la configurazione di parcheggio di chiamata chiamando Set-CsCpsConfiguration. Questa proprietà è impostata su True per impostazione predefinita.

Microsoft Lync Server 2010 è fornito con un file predefinito per la musica di attesa del servizio di parcheggio di chiamata. Se non si assegna un file audio viene utilizzato il file predefinito.

I file audio devono essere nel formato seguente: Windows Media Audio 9, 44 kHz, 16 bit, Mono, CBR o 32 kbps.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Service

Obbligatorio

ServiceId

ID del servizio in cui si trova il servizio di parcheggio di chiamata, ad esempio ApplicationServer:pool0.litwareinc.com.

Content

Obbligatorio

Byte[]

Il contenuto del file audio in formato byte.

Utilizzare il cmdlet Get-Content per recuperare il contenuto del file audio in formato byte. Per informazioni dettagliate, vedere la sezione relativa agli esempi in questo argomento.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare 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

Byte[]. Accetta l'input da pipeline di una matrice di byte contenente il file della musica di attesa.

Tipi restituiti

Questo cmdlet non restituisce un valore.

Esempio

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

$a = Get-Content -ReadCount 0 -Encoding byte "C:\MoHFiles\soothingmusic.wma"
Set-CsCallParkServiceMusicOnHoldFile -Service ApplicationServer:pool0.litwareinc.com -Content $a

Con questo esempio il file SoothingMusic.wma viene impostato come file audio riprodotto ai chiamanti le cui chiamate sono state parcheggiate. La prima riga dell'esempio è una chiamata al cmdlet Windows PowerShell predefinito Get-Content. Questo cmdlet legge semplicemente il contenuto di un file e lo assegna, in questo caso, alla variabile $a. Viene passato un valore di 0 al parametro ReadCount pertanto Get-Content legge l'intero file in una sola volta (anziché tentare di leggerlo riga per riga, operazione non applicabile a un file audio). Il parametro Encoding viene impostato su byte. In questo modo si comunica a Get-Content che il contenuto da leggere nella variabile $a è un array di byte, anziché un file audio nel formato wma.

Nella riga 2 dell'esempio viene effettivamente assegnato il file audio. Viene chiamato Set-CsCallParkServiceMusicOnHoldFile e viene specificato l'ID di servizio in cui è in esecuzione il servizio di parcheggio di chiamata. Viene quindi passato al parametro Content il contenuto del file audio letto nella variabile $a (questo contenuto deve essere nel formato byte).