Remove-CsAnnouncement
Ultima modifica dell'argomento: 2012-03-26
Rimuove un annuncio di Microsoft Lync Server 2010 esistente. Gli annunci vengono riprodotti quando gli utenti compongono un numero di telefono valido ma non assegnato. Un annuncio può essere rappresentato da un messaggio, ad esempio "Questo numero è momentaneamente fuori servizio", oppure da un segnale di occupato.
Sintassi
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Un'organizzazione può disporre di numeri di telefono 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 consente di rimuovere una o più di queste impostazioni di annuncio.
Se si tenta di rimuovere un annuncio che è associato a un intervallo di numeri non assegnati, per impostazione predefinita, viene visualizzato un prompt che richiede se si desidera realmente rimuovere l'annuncio. Se si elimina l'annuncio, la proprietà AnnouncementName di tale intervallo verrà visualizzata con valore Null e quando vengono composti questi numeri, non verrà riprodotto alcun annuncio, bensì solo il segnale di occupato. Il valore della proprietà AnnouncementId, ovvero il GUID dell'annuncio rimosso, tuttavia continuerà a essere visibile.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsAnnouncement 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 "Remove-CsAnnouncement"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Un identificatore univoco dell'annuncio che si desidera rimuovere. 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 rimuovere. In tal modo, verranno rimossi 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 rimuovere. 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. |
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
Nessuno.
Tipi restituiti
Elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.
Esempio
-------------------------- Esempio 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
Il comando precedente rimuove l'annuncio con Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90". Visto che le identità devono essere univoche, questo comando rimuoverà al massimo un solo annuncio.
-------------------------- Esempio 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
Nell'esempio 2 vengono eliminati tutti gli annunci applicati al servizio ApplicationServer:Redmond.litwareinc.com. A tale scopo, viene chiamato Remove-CsAnnouncement insieme al parametro Identity. Se si specifica il valore parametro "ApplicationServer:Redmond.litwareinc.com" (senza il GUID che consente di identificare un annuncio univoco), vengono rimossi tutti gli annunci configurati per il servizio specificato.