• Articolo

New-CsAnnouncement

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare un nuovo annuncio di Microsoft Lync Server 2010. Gli annunci vengono riprodotti quando un utente compone un numero di telefono valido ma non assegnato. Un annuncio può essere un messaggio (quale "Il numero è temporaneamente fuori servizio") o un segnale di occupato.

Sintassi

New-CsAnnouncement -Identity <XdsIdentity> -Name <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnnouncement -Name <String> -Parent <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Una organizzazione può possedere numeri che non sono associati a utenti o telefoni ma sono numeri validi e che possono essere chiamati. Per impostazione predefinita quando qualcuno chiama uno di quei numeri riceverà il segnale di occupato e la chiamata può dare come risultato un errore che viene restituito al client SIP. Applicando le impostazioni di annuncio ai numeri non assegnati, gli amministratori hanno l'opportunità di riprodurre un annuncio, restituire un segnale di occupato o reindirizzare la chiamata. Questo cmdlet crea queste impostazioni di annuncio.

Si possono assegnare annunci ai numeri non assegnati utilizzando i cmdlet New-CsUnassignedNumber o Set-CsUnassignedNumber.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsAnnouncement 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 "New-CsAnnouncement"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Un identificatore univoco per l'annuncio. Per questo valore si deve immettere l'identità dell'Application Server sul quale è in esecuzione l'applicazione Response Group. Ad esempio, ApplicationServer:redmond.litwareinc.com.

Ad un singolo servizio si possono assegnare più di un annuncio. Perciò, per rendere l'identità un valore univoco verrà automaticamente generato un identificatore univoco globale (GUID) che verrà assegnato all'identità quando si crea l'annuncio. Il nuovo annuncio avrà l'identità nel formato service:<service ID>/<GUID>. Ad esempio: service: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. Non è necessario fornire un GUID quando si utilizza questo cmdlet. Fornire invece l'identità di servizio e il GUID verrà automaticamente generato e aggiunto all'identità.

Non è necessario fornire un GUID ma è possibile farlo. Potrebbe essere necessario se era stato assegnato un annuncio ad un intervallo di numeri non assegnati, poi l'annuncio è stato eliminato. È possibile creare un nuovo annuncio con una identità corrispondente (incluso il GUID) ed in quel caso non è necessario aggiornare l'intervallo di numeri non assegnati.

Parent

Facoltativo

Stringa

Questo parametro è identico a Identity, eccetto che Identity accetterà l'identità del servizio e il GUID, laddove Parent accetterà solo l'identità del servizio e genererà automaticamente il GUID. Non è possibile specificare sia Identity sia Parent.

Name

Obbligatorio

Stringa

Un nome descrittivo per l'annuncio. Questo nome deve essere univoco all'interno del servizio. Questo nome verrà utilizzato con New-CsUnassignedNumber o Set-CsUnassignedNumber per specificare l'annuncio associato ad un intervallo di numeri non assegnati.

AudioFilePrompt

Facoltativo

Stringa

Il nome del file audio da riprodurre per l'annuncio. I file audio vengono memorizzati in Archivio file. Per salvare i file audio in Archivio file, utilizzare il cmdlet Import-CsAnnouncementFile.

Tipi di file validi: WAV e WMA

Language

Facoltativo

Stringa

La lingua nella quale verrà riprodotto il prompt TTS. Questo parametro è necessario se viene immesso un valore in TextToSpeechPrompt.

I valori sono immessi come stringa e rappresentano la lingua e le impostazioni locali da utilizzare. Di seguito viene fornito un elenco dei valori validi, seguiti dalla lingua e dalle impostazioni locali tra parentesi: ca-ES (catalano, Catalogna); da-DK (danese, Danimarca); de-DE (tedesco, Germania); en-AU (inglese, Australia); en-CA (inglese, Canada); en-GB (inglese, Regno Unito); en-IN (inglese, India); en-US (inglese, Stati Uniti); es-ES (spagnolo, Spagna); es-MX (spagnolo, Messico); fi-FI (finlandese, Finlandia); fr-CA (francese, Canada); fr-FR (francese, Francia); it-IT (italiano, Italia); ja-JP (giapponese, Giappone); ko-KR (coreano, Corea); nb-NO (norvegese, Bokmal, Norvegia); nl-NL (olandese, Paesi Bassi); pl-PL (polacco, Polonia); pt-BR (portoghese, Brasile); pt-PT (portoghese, Portogallo); ru-RU (russo, Russia); sv-SE (svedese, Svezia); zh-CN (cinese, Repubblica popolare cinese); zh-HK (cinese, Hong Kong - R.A.S.); zh-TW (cinese, Taiwan).

TargetUri

Facoltativo

Stringa

L'URI (Uniform Resource Identifier) a cui verrà trasferito il chiamante dopo la riproduzione dell'annuncio. Questo valore deve essere un indirizzo SIP immesso nel formato sip: seguito dall'indirizzo SIP. Ad esempio, sip:kmyer@litwareinc.com. Si noti che l'indirizzo SIP può anche essere un numero di telefono, ad esempio sip:+14255551212@litwareinc.com;user=phone per un numero di telefono o sip:kmyer@litwareinc.com;opaque=app:voicemail per una casella vocale.

TextToSpeechPrompt

Facoltativo

Stringa

Un prompt per sintesi vocale (TTS). Questa è una stringa che verrà convertita in audio e riprodotta come annuncio.

Se vengono specificati entrambi AudioFilePrompt e TextToSpeechPromp per un singolo annuncio, si verrà avvisati che il file audio avrà la precedenza e il file TTS verrà ignorato.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Esempio

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Help Desk Announcement" -TextToSpeechPrompt "Welcome to the Help Desk." -Language "en-US"

L'Esempio 1 dimostra come creare un nuovo annuncio che riprodurrà un prompt TTS in English (U.S.). Il primo parametro specificato è l'identità. L'identità deve essere in ambito di servizio, seguita dal ID del servizio dell'Application Server (ApplicationServer:redmond.litwareinc.com). Successivamente viene assegnato all'annuncio un nome, in questo caso Help Desk Announcement. Per assegnare un prompt TTS a questo annuncio viene utilizzato il parametro TextToSpeechPrompt seguito da una stringa con il testo dell'annuncio. Quando viene utilizzato un prompt TTS per un annuncio, si deve specificare una lingua includendo il parametro Language seguito da una stringa che rappresenta U.S. English (en-US).

Si noti che l'identità dell'annuncio e composta da due parti: il servizio su cui l'annuncio viene memorizzato e un identificatore univoco globale (GUID) di 36 caratteri. L'identità completa di un nuovo annuncio sarà visibile solo dopo la sua creazione, il GUID viene generato ed applicato automaticamente. L'identità sarà simile a questa: service:ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Welcome Announcement" -AudioFilePrompt "WelcomeMessage.wav"

L'Esempio 2 è simile all'Esempio 1 nel quale si iniziava immettendo i parametri obbligatori, Identity e Name. In questo esempio, tuttavia, al posto di un prompt TTS, come annuncio si vuole riprodurre un file audio. Per fare ciò si include il parametro AudioFilePrompt e gli si fornisce una stringa contenente il nome del file audio (WelcomeMessage.wav). Per essere riprodotto nell'annuncio, il file deve essere memorizzato in Archivio file. Per aggiungere file audio in Archivio file utilizzare il cmdlet Import-CsAnnouncementFile.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri sip:kmyer@litwareinc.com

Come nell'Esempio 2, in questo esempio viene creato un annuncio che riproduce un file audio quando viene chiamato un numero. In questo esempio, tuttavia, in aggiunta ai parametri Identity, Name e AudioFilePrompt viene anche specificato il parametro TargetUri. A questo parametro viene fornito il SIP URI dell'utente o del telefono a cui il chiamante verrà inoltrato dopo la riproduzione dell'annuncio.

-------------------------- Esempio 4 ------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri "sip:+14255551212@litwareinc.com;user=phone"

L'Esempio 4 è identico all'Esempio 3 con la differenza che invece di inoltrare la chiamata basandosi sull'indirizzo SIP di un utente, la chiamata viene inoltrata ad un numero di telefono.

-------------------------- Esempio 5 ------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Busy"

In questo esempio non viene specificato né un prompt né un URI di destinazione, vengono inclusi solo Identity e Name. Ciò significa che il chiamante udrà un segnale di occupato quando chiamerà un numero non assegnato associato a questo annuncio.