Condividi tramite

  • Articolo

Grant-CsDialPlan

 

Ultima modifica dell'argomento: 2012-03-23

Assegna un dial plan a uno o più utenti o gruppi.

Sintassi

Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet assegna a un utente un dial plan per utente già esistente. I dial plan forniscono informazioni necessarie per consentire agli utenti di VoIP aziendale di effettuare telefonate. Gli utenti che non dispongono di un dial plan valido non potranno effettuare chiamate con VoIP aziendale. Un dial plan determina le regole di normalizzazione applicate e se è necessario comporre un prefisso per le chiamate esterne.

È possibile controllare se a un utente è stato concesso un dial plan per utente chiamando un comando in questo formato: Get-CsUser "<nome utente>" | Select-Object DialPlan. Ad esempio:

Get-CsUser "Davide Garghentini" | Select-Object DialPlan

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

L'identità (identificatore univoco) dell'utente a cui è stato assegnato il dial plan.

Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente; 2) l'UPN (Universal Principal Name) dell'utente; 3) il nome di dominio e il nome di accesso dell'utente, nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Active Directory dell'utente (ad esempio, Davide Garghentini).

È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il valore di Display Name per il parametro Identity per l'utente. Ad esempio, il parametro Identity "* Smith" restituisce tutti gli utenti con cognome Smith.

Tipo di dati completi: Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Facoltativo

Stringa

Il valore Identity del dial plan da assegnare all'utente. (Il nome include solo la porzione del nome dell'Identity. Le identità dei dial plan per utente includono un prefisso tag: che non può essere incluso nel parametro PolicyName.)

DomainController

Facoltativo

FQDN

Consente di specificare un controller di dominio. Se non è specificato alcun controller di dominio, verrà utilizzato il primo disponibile.

PassThru

Facoltativo

Parametro opzionale

Restituisce i risultati del comando. Per impostazione predefinita, il cmdlet non genera alcun output.

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

Stringa. Accetta un valore stringa da pipeline che rappresenta l'identità di un account utente a cui viene assegnato il dial plan.

Tipi restituiti

Se utilizzato con il parametro PassThru, restituisce un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Esempio

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

Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

Con l'esempio riportato viene utilizzato Grant-CsDialPlan per assegnare il dial plan RedmondDialPlan all'utente con identità (in questo caso il nome visualizzato) Davide Garghentini.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

Con l'esempio 2 viene assegnato il dial plan RedmondDialPlan a tutti gli utenti i cui uffici si trovano nella città di Redmond. Per eseguire questa operazione, viene chiamato il cmdlet Get-CsUser per recuperare una raccolta di tutti gli utenti il cui ufficio si trova nella città di Redmond; l'operazione viene eseguita con il parametro LDAPFilter e la query LDAP l=Redmond. Nel linguaggio di query LDAP utilizzato da Servizi di dominio Active Directory, l indica la località di un utente, o la sua città. La raccolta filtrata viene quindi inviata tramite pipe a Grant-CsDialPlan, che assegna il dial plan Redmond ad ogni utente nella raccolta.