Condividi tramite

  • Articolo

Get-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni su uno o più criteri vocali configurati per l'organizzazione.

Sintassi

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

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

Descrizione dettagliata

Questo cmdlet recupera informazioni sui criteri vocali. I criteri vocali sono utilizzati per gestire funzionalità di VoIP aziendale quali, ad esempio, lo squillo simultaneo (vale a dire la capacità di far squillare un secondo telefono ogni volta che si riceve una chiamata sul telefono dell'ufficio) e l'inoltro di chiamata. Utilizzare questo cmdlet per recuperare le impostazioni che permettono di abilitare e disabilitare molte di queste funzionalità.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsVoicePolicy in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Get-CsVoicePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Un identificatore univoco che specifica l'ambito, e in alcuni casi il nome, del criterio. Se questo parametro viene omesso, vengono restituiti tutti i criteri vocali per l'organizzazione.

Filter

Facoltativo

Stringa

Questo parametro accetta una stringa di caratteri jolly e restituisce tutti i criteri vocali con identità corrispondenti a tale stringa. Ad esempio, con un valore site:* per Filter vengono restituiti tutti i criteri vocali definiti a livello di sito.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i criteri vocali dalla replica locale del archivio di gestione centrale anziché dal archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Il cmdlet restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy.

Esempio

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

Get-CsVoicePolicy

Con questo esempio vengono visualizzati tutti i criteri vocali definiti per un'organizzazione insieme alle relative impostazioni di ognuno.

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

Get-CsVoicePolicy -Identity UserPolicy1

Con questo esempio viene utilizzato il parametro Identity per recuperare le impostazioni dei criteri vocali per il criterio per utente denominato UserPolicy1.

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

Get-CsVoicePolicy -Filter tag*

Con questo esempio viene utilizzato il parametro Filter per recuperare tutte le impostazioni dei criteri vocali che possono essere assegnate agli utenti. Tutti i criteri vocali utente dispongono di un parametro Identity nel formato **tag:>**UserVoicePolicy<, pertanto è possibile applicare un filtro sul tag per recuperare tutti i criteri vocali utente.