Condividi tramite

  • Articolo

Get-CsVoiceRoute

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle route vocali configurate per l'uso in un'organizzazione.

Sintassi

Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

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

Descrizione dettagliata

Utilizzare questo cmdlet per recuperare una o più route vocali esistenti. Le route vocali contengono istruzioni che comunicano a Microsoft Lync Server 2010 come instradare le chiamate effettuate da utenti di VoIP aziendale a numeri di telefono della rete PSTN (Public Switched Telephone Network) o di un centralino (PBX, Private Branch Exchange).

Questo cmdlet può essere utilizzato per recuperare informazioni sulle route vocali, ad esempio a quali gateway PSTN è associata la route, quali utilizzi PSTN sono associati alla route, il modello (sotto forma di espressione regolare) che identifica i numeri di telefono a cui si applica la route e le impostazioni per l'ID del chiamante. L'utilizzo PSTN associa la route vocale a un criterio telefonico.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsVoiceRoute in locale: RTCUniversalUserAdmins, 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 "Get-CsVoiceRoute"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

Una stringa che identifica in modo univoco la route vocale. Se non viene fornita un'identità, vengono restituite tutte le route vocali per l'organizzazione.

Filter

Facoltativo

Stringa

Questo parametro consente di filtrare i risultati dell'operazione Get in base al carattere jolly passato al parametro.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare la route vocale 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.Route.

Esempio

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

Get-CsVoiceRoute

Consente di recuperare le proprietà per tutte le route vocali definite nell'organizzazione.

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

Get-CsVoiceRoute -Identity Route1

Consente di recuperare le proprietà per la route vocale Route1.

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

Get-CsVoiceRoute -Filter *test*

Questo comando consente di visualizzare le impostazioni della route vocale la cui identità contiene la stringa "test" in qualsiasi posizione all'interno del valore. Per trovare la stringa test solo alla fine dell'identità, utilizzare il valore *test. Analogamente, per trovare la stringa test solo all'inizio dell'identità, specificare il valore test*.

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

Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}

Questo comando consente di recuperare tutte le route vocali a cui non sono assegnati gateway PSTN. Per prima cosa vengono recuperate tutte le route vocali utilizzando il cmdlet Get-CsVoiceRoute. Queste route vocali vengono quindi inviate tramite pipe al cmdlet Where-Object. Where-Object circoscrive i risultati dell'operazione Get. In questo caso viene esaminata ogni route vocale (ecco che cosa rappresenta $_) e viene controllata la proprietà Count della proprietà PstnGatewayList. Se il conteggio di gateway PSTN è pari a 0, l'elenco è vuoto per la route non sono stati definiti gateway.