Condividi tramite

  • Articolo

Set-CsAnnouncement

 

Ultima modifica dell'argomento: 2012-03-26

Modifica i valori delle proprietà di un annuncio Microsoft Lync Server 2010 esistente. Gli annunci vengono riprodotti quando gli utenti compongono un numero di telefono valido ma non assegnato. Un annuncio può corrispondere a un messaggio (ad esempio "Il numero è temporaneamente fuori servizio") o a un segnale di occupato.

Sintassi

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

Set-CsAnnouncement [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Language <String>] [-Name <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Un'organizzazione può disporre di numeri telefonici non assegnati a utenti o telefoni, ma che sono tuttora numeri validi per le chiamate. Per impostazione predefinita, quando un utente compone uno di questi numeri riceve un segnale di occupato e la chiamata può generare un errore restituito al client SIP. Applicando le impostazioni di annuncio ai numeri non assegnati, gli amministratori possono decidere di riprodurre un messaggio, restituire un segnale di occupato o reindirizzare la chiamata. Questo cmdlet consente di modificare queste impostazioni di annuncio.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsAnnouncement in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Un identificatore univoco per l'annuncio. Questo valore sarà sempre nel formato <serviceID>/<GUID>, dove serviceID è l'identità del server applicazioni che esegue il servizio Annuncio e GUID è un identificatore univoco globale associato a queste impostazioni di annuncio. Ad esempio: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Dal momento che può essere difficile immettere correttamente i GUID nella riga di comando, è più comodo recuperare gli annunci utilizzando il cmdlet Get-CsAnnouncement e inviarli tramite pipe al cmdlet Set-CsAnnouncement per la modifica. Per informazioni dettagliate, vedere la sezione Esempi.

Instance

Facoltativo

Announcement

Un riferimento all'oggetto annuncio da modificare. Questo oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement e può essere recuperato chiamando il cmdlet Get-CsAnnouncement.

Name

Facoltativo

Stringa

Immettere un valore per questo parametro per modificare il nome dell'annuncio. I nomi devono essere univoci all'interno di un servizio.

AudioFilePrompt

Facoltativo

Stringa

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

Tipi di file validi: WAV e WMA.

TextToSpeechPrompt

Facoltativo

Stringa

Un prompt di sintesi vocale. È una stringa che sarà convertita in un audio e riprodotta come annuncio.

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

Language

Facoltativo

Stringa

La lingua in cui sarà riprodotto il prompt di sintesi vocale. Se viene immesso un valore per TextToSpeechPrompt, questo parametro è obbligatorio.

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 a cui sarà 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 o di segreteria telefonica, ad esempio sip:+14255551212@litwareinc.com;user=phone per un numero di telefono o sip:kmyer@litwareinc.com;opaque=app:voicemail per una segreteria telefonica.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement. Consente di accettare l'input da pipeline di oggetti annuncio.

Tipi restituiti

Set-CsAnnouncement non restituisce alcun oggetto o valore. Il cmdlet modifica invece le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Esempio

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -AudioFilePrompt "helpdesk.wav"

Il comando mostrato nell'esempio 1 consente di assegnare un nuovo file audio all'annuncio Help Desk Announcement. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsAnnouncement senza parametri per restituire una raccolta di tutti gli annunci attualmente disponibili. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona l'unico annuncio in cui Name equivale (-eq) a "Help Desk Announcement". A sua volta, l'annuncio viene inviato tramite pipe a Set-CsAnnouncement, che imposta il valore della proprietà AudioFilePrompt su helpdesk.wav.

Se a questo annuncio è già assegnato un valore TextToSpeechPrompt, il comando genera un avviso che segnala che il valore TextToSpeechPrompt sarà ignorato.

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TextToSpeechPrompt $Null

Con l'esempio 2, la proprietà TextToSpeechPrompt per l'annuncio Help Desk Announcement viene impostata su un valore null; in questo modo viene cancellato il valore della proprietà. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsAnnouncement per restituire una raccolta di tutti gli annunci attualmente disponibili. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona l'annuncio in cui Name equivale (-eq) a "Help Desk Announcement". L'annuncio viene quindi inviato tramite pipe al cmdlet Set-CsAnnouncement, che imposta il valore della proprietà TextToSpeechPrompt su un valore null ($Null).

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TargetUri "sip:kmyer@litwareinc.com;opaque=app:voicemail"

Con questo esempio viene aggiornato TargetUri per l'annuncio denominato Help Desk Announcement. Il comando utilizza per prima cosa Get-CsAnnouncement per restituire una raccolta di tutti gli annunci attualmente disponibili. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona l'annuncio in cui Name equivale (-eq) a "Help Desk Announcement". L'annuncio viene quindi inviato tramite pipe al cmdlet Set-CsAnnouncement, che imposta il valore della proprietà TargetUri su un percorso di segreteria telefonica (sip:kmyer@litwareinc.com;opaque=app:voicemail).