Set-CsDialPlan
Ultima modifica dell'argomento: 2012-03-27
Modifica un dial plan esistente.
Sintassi
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Questo cmdlet consente di modificare un dial plan esistente (detto anche profilo di numerazione locale). 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: Sebbene le regole di normalizzazione di un dial plan possano essere modificate con questo cmdlet, è preferibile utilizzare i cmdlet New-CsVoiceNormalizationRule, Set-CsVoiceNormalizationRule o Remove-CsVoiceNormalizationRule per tale operazione. Le modifiche apportate con questi cmdlet vengono rispecchiate solo nel dial plan corrispondente.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-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 "Set-CsDialPlan"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
L'identificatore univoco che specifica l'ambito, o nel caso dei dial plan per utente, il nome, che identifica il dial plan da modificare. Ad esempio, l'identità di un sito deve essere immessa nel formato site:<nomeSito>, dove nomeSito è il nome del sito. Un dial plan nell'ambito del servizio sarà 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. |
Instance |
Facoltativo |
LocationProfile |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Per recuperare questo riferimento a oggetto è possibile chiamare il cmdlet Get-CsDialPlan. |
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. Il valore di questo parametro deve corrispondere all'espressione regolare [0-9]{1,4}. Significa che deve essere un valore con una lunghezza compresa tra una e quattro cifre e in cui ogni cifra è compresa tra 0 e 9. |
NormalizationRules |
Facoltativo |
PSListModifier |
Un elenco di regole di normalizzazione applicate a questo dial plan. Anche se l'elenco e le regole possono essere create direttamente con questo cmdlet, è consigliabile creare le regole di normalizzazione con il cmdlet New-CsVoiceNormalizationRule, che crea la regola e la assegna al dial plan specificato, modificandole con il cmdlet 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. |
SimpleName |
Facoltativo |
Stringa |
Nome descrittivo del dial plan. I nomi dei dial plan devono essere univoci in tutti i dial plan in una distribuzione di Microsoft Lync Server 2010. 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 (()). |
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. |
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.LocationProfile. Consente di accettare l'input da pipeline di oggetti dial plan.
Tipi restituiti
Set-CsDialPlan non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
Con l'esempio 1 viene utilizzato Set-CsDialPlan per modificare il dial plan con Identity RedmondDialPlan. In questo caso l'unica proprietà modificata è Description; per eseguire questa modifica viene specificato il parametro Description seguito dal testo della nuova descrizione.
-------------------------- Esempio 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
Con questo esempio viene utilizzato Set-CsDialPlan per cambiare il valore della proprietà ExternalAccessPrefix per tutti i dial plan configurati per l'uso nell'organizzazione. Per ottenere tale risultato, il comando utilizza per prima cosa Get-CsDialPlan per restituire una raccolta di tutti i dial plan nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Set-CsDialPlan, che assegna il valore 8 alla proprietà ExternalAccessPrefix per ogni profilo nella raccolta.