New-CsDialPlan
Ultima modifica dell'argomento: 2012-03-27
Crea un nuovo dial plan.
Sintassi
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Questo cmdlet consente di creare un nuovo dial plan (detto anche profilo località). 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.
La creazione di un dial plan provoca la creazione automatica di una regola di normalizzazione vocale predefinita. Le regole di normalizzazione possono essere modificate chiamando il cmdlet Set-CsVoiceNormalizationRule. Le nuove regole di normalizzazione possono essere aggiunte a un dial plan chiamando il cmdlet New-CsVoiceNormalizationRule.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsDialPlan in locale: 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 "New-CsDialPlan"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Un identificatore univoco che specifica l'ambito e il nome (sito), il ruolo del servizio e il nome di dominio completo, oppure il nome (per utente) per identificare il dial plan. Ad esempio, l'identità di un sito deve essere immessa nel formato <nomeSito>, dove nomeSito è il nome del sito. Un dial plan nell'ambito del servizio deve essere un servizio gateway PSTN o Registrar, il cui valore di identità è formattato come segue: Registrar:Redmond.litwareinc.com. Un'identità per utente viene immessa come un valore stringa univoco. |
Description |
Facoltativo |
Stringa |
Una descrizione del dial plan: qual è il suo scopo, a quale tipo di utente si applica o qualsiasi altra informazione utile per identificare lo scopo del dial plan. Numero massimo di caratteri: 512 |
DialinConferencingRegion |
Facoltativo |
Stringa |
Il nome dell'area geografica associata a questo dial plan. Specificare un valore per questo parametro se il dial plan sarà utilizzato per le conferenze telefoniche con accesso esterno. In questo modo è possibile assegnare il numero di accesso corretto quando l'organizzatore configura la conferenza. Per recuperare le aree geografiche disponibili è possibile chiamare il cmdlet Get-CsNetworkRegion. Numero massimo di caratteri: 512 |
ExternalAccessPrefix |
Facoltativo |
Stringa |
Un numero (o un set di numeri) che identifica la chiamata come esterna all'organizzazione. Ad esempio, per chiamare una linea esterna potrebbe essere necessario premere 9. Questo prefisso sarà ignorato dalle regole di normalizzazione, che saranno quindi applicate alla parte rimanente del numero. Il parametro OptimizeDeviceDialing deve essere impostato su True affinché questo valore abbia effetto. Questo parametro deve corrispondere all'espressione regolare [0-9]{1,4}. Significa che deve essere un valore compreso tra 0 e 9 con una lunghezza compresa tra una e quattro cifre. Valore predefinito: 9 |
NormalizationRules |
Facoltativo |
PSListModifier |
Un elenco di regole di normalizzazione applicate a questo dial plan. Anche se l'elenco e le regole possono essere creati direttamente con questo cmdlet, è consigliabile creare le regole di normalizzazione con il cmdlet New-CsVoiceNormalizationRule, che consente di creare la regola e assegnarla al dial plan specificato. Ogni volta che viene creato un nuovo dial plan, viene creata anche una nuova regola di normalizzazione vocale con impostazioni predefinite per tale dial plan di sito, servizio o per utente. Per impostazione predefinita, l'identità della nuova regola di normalizzazione vocale corrisponde all'identità del dial plan seguita da una barra e dal nome Prefix All. Ad esempio: site:Redmond/Prefix All. Valore predefinito: {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Nota: questa impostazione predefinita non è altro che un segnaposto. Per utilizzare il dial plan è necessario modificare la regola di normalizzazione creata dal dial plan oppure creare una nuova regola per il sito, servizio o utente. È possibile creare una nuova regola di normalizzazione chiamando il cmdlet New-CsVoiceNormalizationRule; per modificare una regola di normalizzazione, chiamare Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Facoltativo |
Booleano |
Impostando questo parametro su True, alle chiamate esterne all'organizzazione sarà applicato il prefisso specificato nel parametro ExternalAccessPrefix. Questo valore può essere impostato su True solo se è stato specificato un valore per il parametro ExternalAccessPrefix. Valore predefinito: False |
SimpleName |
Facoltativo |
Stringa |
Nome visualizzato del dial plan. Questo nome deve essere univoco all'interno della distribuzione di Lync Server. La stringa può contenere fino a 256 caratteri. I caratteri validi sono le lettere dell'alfabeto e i numeri, il trattino (-), il punto (.), il segno più (+), il carattere di sottolineatura (_) e le parentesi (()). Questo parametro deve contenere un valore. Tuttavia, se non si specifica un valore nella chiamata a New-CsDialPlan, viene utilizzato un valore predefinito. Il valore predefinito per un dial plan Global è Prefix All. L'impostazione predefinita per un dial plan a livello di sito è il nome del sito. L'impostazione predefinita per un servizio è il nome del servizio (Registrar o Gateway PSTN) seguito da un carattere di sottolineatura e dal nome di dominio completo (FQDN) del servizio. Ad esempio: Registrar_pool0.litwareinc.com. L'impostazione predefinita per un dial plan per utente è l'identità del dial plan. |
State |
Facoltativo |
Stringa |
Questo parametro non è utilizzato con questo cmdlet. |
City |
Facoltativo |
Stringa |
Questo parametro non è utilizzato con questo cmdlet. |
CountryCode |
Facoltativo |
Stringa |
Questo parametro non è utilizzato con questo cmdlet. |
Force |
Facoltativo |
Parametro opzionale |
Consente di ignorare le richieste di conferma prima di apportare modifiche. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
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
Questo cmdlet consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Esempio
-------------------------- Esempio 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
Con il comando mostrato nell'esempio 1 è possibile creare un nuovo dial plan con identità RedmondDialPlan. L'assenza di un ambito nel valore di Identity indica che si tratta di un criterio per utente. I dial plan creati con ambito per utente possono essere assegnati direttamente a utenti e gruppi. Tutte le altre proprietà del dial plan sono impostate sui valori predefiniti.
-------------------------- Esempio 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
Con i comandi mostrati nell'esempio 2 viene creato un nuovo dial plan con Identity site:Redmond (vale a dire che il dial plan si applica a tutti gli utenti nel sito Redmond a cui non è assegnato un dial plan a livello di servizio o per utente) e SimpleName RedmondSiteDialPlan. La riga successiva nell'esempio consente di creare una nuova regola di normalizzazione associata al dial plan. La regola di normalizzazione predefinita per un dial plan viene creata principalmente come segnaposto; i valori sono di uso limitato. Pertanto, dopo aver chiamato il cmdlet New-CsDialPlan per creare un nuovo dial plan, è opportuno chiamare New-CsVoiceNormalizationRule per creare una regola denominata funzionale per l'organizzazione. Questo è lo scopo della riga 2 dell'esempio, che chiama New-CsVoiceNormalizationRule e crea una regola per il sito Redmond con il nome SeattlePrefix, specificando le proprietà Pattern e Translation per la regola. Non servono altri passaggi per modificare il dial plan; le modifiche alla regola di normalizzazione vengono automaticamente applicate al dial plan la cui identità corrisponde a quella della regola di normalizzazione. La parte site:Redmond del parametro Identity corrisponde all'identità del dial plan; SeattlePrefix è il nome della regola di normalizzazione. A un dial plan è possibile applicare più regole di normalizzazione, quindi ogni regola di normalizzazione necessita di un nome univoco in un dato ambito.
-------------------------- Esempio 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
Con il comando mostrato nell'esempio 3 è possibile creare un nuovo dial plan con Identity RedmondDialPlan e specificare un parametro Description che spieghi lo scopo del dial plan. I dial plan creati con ambito per utente possono essere assegnati direttamente a utenti e gruppi. A tutti gli altri parametri saranno assegnati i valori predefiniti.