Condividi tramite


Remove-CsVoiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di riportare la configurazione vocale ai valori predefiniti.

Sintassi

Remove-CsVoiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le configurazioni di test vocali sono utilizzate per testare un numero di telefono rispetto a specifici criteri vocali, route e dial plan. Questo cmdlet consente di rimuovere la configurazione vocale globale (e solo questa), vale a dire un contenitore per tutte le configurazioni di test vocali definite in una distribuzione di Microsoft Lync Server 2010. Con la "rimozione", la configurazione vocale non viene realmente rimossa in quanto l'istanza globale resta disponibile. In realtà, l'elenco di configurazioni di test vocali viene riportato all'impostazione predefinita (vale a dire un elenco vuoto).

AVVISO: con la rimozione della configurazione vocale (che svuota l'elenco delle configurazioni di test vocali) vengono eliminate tutte le configurazioni di test vocali definite per una distribuzione di Lync Server 2010. Dopo aver utilizzato questo cmdlet, l'utilizzo del cmdlet Get-CsVoiceTestConfiguration non restituisce alcun risultato.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

L'ambito della configurazione vocale da rimuovere. Questo valore deve essere Global.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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.Policy.Voice.VoiceConfiguration. Accetta l'input tramite pipeline di un oggetto configurazione vocale.

Tipi restituiti

Questo cmdlet rimuove (ripristina) un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.

Esempio

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

Remove-CsVoiceConfiguration -Identity Global -Confirm

Con questo esempio la configurazione vocale Global (e solo questa) viene riportata ai valori predefiniti. Con questa operazione vengono eliminate tutte le configurazioni di test vocali definite, pertanto è stato aggiunto il parametro Confirm al fine di visualizzare un prompt che richiede di confermare l'operazione prima che abbia luogo la rimozione.