Condividi tramite

  • Articolo

Get-CsDialPlan

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui dial plan utilizzati nell'organizzazione.

Sintassi

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

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

Descrizione dettagliata

Questo cmdlet restituisce informazioni su uno o più dial plan (conosciuti anche come profili di numerazione locale) in un'organizzazione. I dial plan forniscono informazioni necessarie per consentire agli utenti di VoIP aziendale di effettuare telefonate. I dial plan sono utilizzati anche da applicazione Operatore Conferenza per le conferenze telefoniche con accesso esterno. Un dial plan determina le regole di normalizzazione applicate e se è necessario comporre un prefisso per le chiamate esterne.

Nota: è possibile utilizzare Get-CsDialPlan per recuperare informazioni specifiche sulle regole di normalizzazione di un dial plan, ma se questa è l'unica informazione che si desidera recuperare, è possibile anche utilizzare il cmdlet Get-CsVoiceNormalizationRule.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsDialPlan in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialPlan"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco che designa l'ambito, l'ambito per utente e un nome per identificare il dial plan che si desidera recuperare.

Filter

Facoltativo

Stringa

Esegue una ricerca con caratteri jolly che consente di restringere i risultati ai dial plan con identità che corrispondono alla stringa con carattere jolly data.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni sui dial plan dalla replica locale del archivio di gestione centrale, anziché dal archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Questo cmdlet restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

Esempio

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

Get-CsDialPlan

Nell'esempio 1 viene restituita una raccolta di tutti i dial plan configurati per essere utilizzati nell'organizzazione richiamando Get-CsDialPlan senza parametri aggiuntivi.

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

Get-CsDialPlan -Identity RedmondDialPlan

Nell'esempio 2 il parametro Identity viene utilizzato per limitare i dati recuperati ai dial plan che dispongono di un dial plan per utente con Identity RedmondDialPlan. Poiché le identità devono essere univoche, il comando restituirà solo il dial plan specificato.

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

Get-CsDialPlan -Identity site:Redmond

L'esempio 3 è identico all'esempio 2, tranne per il fatto che, invece di recuperare un dial plan per utente, recupera un dial plan assegnato a un sito. Per fare ciò, si utilizza il valore site: seguito dal nome del sito (in questo caso Redmond) da recuperare.

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

Get-CsDialPlan -Filter tag:*

In questo esempio viene utilizzato il parametro Filter per restituire una raccolta di tutti i dial plan che sono stati configurati con ambito per utente. (Le impostazioni configurate con ambito per utente o tag possono essere assegnate direttamente agli utenti e ai gruppi). La stringa con carattere jolly tag:* istruisce il cmdlet affinché restituisca solo i dial plan con identità che inizia con il valore stringa tag:, che identifica un dial plan come dial plan per utente.

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

Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

Nell'esempio vengono visualizzate le regole di normalizzazione utilizzate dai dial plan configurati per l'utilizzo nell'organizzazione. Poiché la proprietà NormalizationRules si compone di un array di oggetti, di solito l'insieme completo delle regole di normalizzazione non viene visualizzato sullo schermo. Per vedere tutte le regole, questo comando utilizza come prima cosa Get-CsDialPlan per recuperare una raccolta di tutti i dial plan. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, al contrario il parametro ExpandProperty di Select-Object viene utilizzato per espandere i valori trovati nella proprietà NormalizationRules. Espandendo i valori, tutte le regole di normalizzazione verranno visualizzate sullo schermo, lo stesso risultato che si otterrebbe chiamando Get-CsVoiceNormalizationRule.

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

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}

Nell'esempio 6, Get-CsDialPlan e Where-Object vengono utilizzati per recuperare una raccolta di tutti i dial plan che includono la parola Redmond nella loro descrizione. A tale scopo, per prima cosa il comando utilizza Get-CsDialPlan per recuperare tutti i dial plan. La raccolta verrà quindi inviata tramite pipe a Where-Object, che applica un filtro che limita i dati restituiti ai profili che contengono la parola Redmond all'interno della descrizione.