Condividi tramite

  • Articolo

Grant-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-23

Assegna i criteri vocali a uno o più utenti o gruppi.

Sintassi

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

Descrizione dettagliata

Questo cmdlet assegna a un utente criteri vocali per utente già esistenti. I criteri vocali sono utilizzati per gestire funzionalità di VoIP aziendale quali, ad esempio, lo squillo simultaneo (vale a dire la capacità di far squillare un secondo telefono ogni volta che si riceve una chiamata sul telefono dell'ufficio) e l'inoltro di chiamata. Utilizzare questo cmdlet per assegnare le impostazioni che abilitano e disabilitano queste funzionalità per un utente specifico.

È possibile controllare se a un utente sono stati concessi criteri vocali per utente chiamando un comando in questo formato: Get-CsUser "<nome utente>" | Select-Object VoicePolicy. Ad esempio:

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

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Grant-CsVoicePolicy i membri dei seguenti gruppi: RTCUniversalUserAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

Il parametro Identity (identificatore univoco) dell'utente a cui è stato assegnato il criterio.

Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) L'indirizzo SIP dell'utente; 2) il nome dell'entità utente (UPN); 3) il nome del dominio dell'utente e il nome di accesso nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini); infine, 4) il nome visualizzato in Servizi di dominio 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 nome (Identity) del criterio vocale da assegnare all'utente. (Il nome include solo la porzione del nome dell'Identity. Le identità criterio per utente includono un prefisso di 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à dell'account utente a cui viene assegnato il criterio vocale.

Tipi restituiti

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

Esempio

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

Grant-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond

Questo esempio assegna il criterio vocale con il valore Identity VoicePolicyRedmond all'utente con il nome di visualizzazione Davide Garghentini.

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

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsVoicePolicy -PolicyName VoicePolicyRedmond

In questo esempio viene assegnato il criterio vocale con valore Identity VoicePolicyRedmond a tutti gli utenti dell'unità organizzativa (OU) Finance: OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com. Nella prima parte del comando viene chiamato il cmdlet Get-CsUser per recuperare tutti gli utenti abilitati per Lync Server 2010 o Office Communications Server dall'unità organizzativa specificata. Questa raccolta di utenti viene quindi inviata tramite pipe al cmdlet Grant-CsVoicePolicy, che assegna il criterio VoicePolicyRedmond a ognuno di questi utenti.