Condividi tramite

  • Articolo

Get-CsAnnouncement

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sugli annunci di Microsoft Lync Server 2010 configurati per l'uso nell'organizzazione. Gli annunci vengono riprodotti quando gli utenti compongono un numero di telefono valido ma non assegnato. Un annuncio può essere un messaggio, ad esempio "Questo numero è momentaneamente fuori servizio", oppure un segnale di occupato.

Sintassi

Get-CsAnnouncement [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAnnouncement [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Un'organizzazione può disporre di numeri telefonici non assegnati a utenti o telefoni, ma che sono comunque 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 recupera una o più di queste impostazioni per annunci.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsAnnouncement i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsAnnouncement"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identity XDS

Un identificatore per l'annuncio che si desidera recuperare. Se si omettono questo parametro e il parametro Filter, verranno visualizzate tutte le istanze di annunci configurate per l'organizzazione. Il valore per il parametro Identity può essere fornito in uno dei seguenti modi:

- Immettere l'identità del Servizio applicazione per gli annunci che si desidera recuperare. In tal modo, verranno recuperati tutti gli annunci configurati che presentano l'identità del servizio fornita. Ad esempio, ApplicationServer:Redmond.litwareinc.com.

- Immettere l'identità completa del singolo annuncio che si desidera recuperare. Questo valore sarà sempre nel formato <IDservizio>/<GUID>, dove IDservizio è l'identità del server applicazioni nel quale è in esecuzione il Servizio annunci, mentre GUID è un identificatore univoco globale associato a questo annuncio. Ad esempio: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Filter

Facoltativo

Stringa

Questo parametro consente di eseguire una ricerca mediante caratteri jolly nell'identità di tutti gli annunci configurati per l'organizzazione. Utilizzare il carattere jolly (*) per applicare un filtro per qualsiasi parte del valore Identity.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative agli annunci dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Restituisce una o più istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

Esempio

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

Get-CsAnnouncement

Nell'esempio 1 vengono restituiti tutti gli annunci configurati per l'utilizzo nell'organizzazione. A tale scopo, viene chiamato Get-CsAnnouncement senza alcun parametro.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"

Il comando precedente restituisce un singolo annuncio: l'annuncio con l'identità ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90. Per un metodo alternativo (e probabilmente più semplice) per recuperare un annuncio specifico, vedere l'esempio 5.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com"

Il comando utilizzato nell'esempio 3 restituisce informazioni su tutti gli annunci configurati per l'utilizzo nel servizio ApplicationServer:redmond.litwareinc.com.

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

Get-CsAnnouncement -Filter "*ApplicationServer:Redmond*"

Nell'esempio 4 vengono restituite informazioni per tutti gli annunci configurati per l'utilizzo nel sito Redmond (per tutti i domini). A tale scopo, è necessario includere il parametro Filter e il valore di filtro "*ApplicationServer:Redmond*" in modo da limitare i dati restituiti agli annunci il cui valore Identity contiene il valore stringa "ApplicationServer:Redmond". Per definizione, tali annunci sono quelli configurati per l'uso nel sito Redmond.

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Welcome Announcement"}

Nell'esempio 5 viene mostrato un metodo alternativo per restituire un annuncio specifico o un insieme di annunci, in questo caso tutti gli annunci denominati Welcome Announcement. A tale scopo, viene innanzitutto chiamato Get-CsAnnouncement senza alcun parametro per restituire una raccolta di tutti gli annunci in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona gli annunci con nome uguale a (-eq) "Welcome Announcement".

-------------------------- Esempio 6 ------------------------

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com" | Where-Object {$_.Name -eq "Welcome Announcement"}

In questo esempio, che è simile a quello precedente, viene mostrato un altro metodo per restituire un singolo annuncio. Viene di nuovo chiamato Get-CsAnnouncement, ma questa volta specificando il valore Identity ApplicationServer:redmond.litwareinc.com. In tal modo, verrà restituita una raccolta di tutti gli annunci associati al servizio. Come nell'esempio 5, questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona gli annunci con nome uguale a (-eq) "Welcome Announcement". Poiché in un Servizio applicazione i nomi degli annunci devono essere univoci, questo comando non restituirà mai più di un singolo elemento.

-------------------------- Esempio 7 ------------------------

Get-CsAnnouncement | Where-Object {$_.Name -like "Welcome*"}

Questo esempio è simile all'esempio 5, in quanto vengono recuperati tutti gli annunci e successivamente la relativa raccolta viene inviata tramite pipe al cmdlet Where-Object. Tuttavia, nell'esempio 5 è stato utilizzato l'operatore –eq nella clausola where per trovare una corrispondenza esatta per il nome. In questo esempio sono stati utilizzati l'operatore –like e un valore con carattere jolly per trovare tutti gli annunci che, in questo caso, iniziano con la stringa Welcome.

-------------------------- Esempio 8 ------------------------

Get-CsAnnouncement | Where-Object {($_.TextToSpeechPrompt -ne $Null) -and ($_.Language -ne "en-US")}

Nell'esempio 8 vengono restituite le informazioni relative a tutti gli annunci per i quali viene utilizzato un prompt di sintesi vocale (come annuncio principale o come fallback su un file audio), ma non l'inglese americano come lingua. Per eseguire questa attività, il comando chiama innanzitutto Get-CsAnnouncement per restituire una raccolta di tutti gli annunci attualmente configurati. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona tutti gli annunci in cui la proprietà TextToSpeechPrompt non è vuota (non è uguale a $Null) e in cui la proprietà Language non è uguale a (-ne) en-US.