Condividi tramite

  • Articolo

Grant-CsHostedVoicemailPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Assegna un criterio di segreteria telefonica ospitata nell'ambito per utente. L'ambito per utente consente di assegnare criteri a singoli utenti o gruppi.

Sintassi

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

Descrizione dettagliata

Questo cmdlet assegna un criterio di segreteria telefonica ospitato a un utente. Un criterio di segreteria telefonica ospitata specifica come instradare le chiamate senza risposta a un servizio Messaggistica unificata di Exchange ospitato.

È possibile controllare se a un utente sono stati assegnati criteri di segreteria telefonica ospitata per utente chiamando un comando nel formato seguente: Get-CsUser "<nome utente>" | Select-Object HostedVoicemailPolicy. Ad esempio:

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

Se si assegna a un utente un criterio di segreteria telefonica ospitata senza destinazione, non sarà possibile abilitare tale utente per la segreteria telefonica ospitata.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Grant-CsHostedVoicemailPolicy 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-CsHostedVoicemailPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

Identità (identificatore univoco) dell'utente a cui viene assegnato il criterio di segreteria telefonica ospitata.

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, User Principal Name), 3) il nome di dominio e il nome di accesso dell'utente nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini) e infine 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

Nome (identità) del criterio di segreteria telefonica ospitata da assegnare all'utente. (Il nome include solo la porzione del nome dell'Identity. Le identità criterio di segreteria telefonica ospitata 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 di segreteria telefonica ospitata.

Tipi restituiti

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

Esempio

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

Grant-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond

In questo esempio viene assegnato il criterio di segreteria telefonica ospitata con valore Identity ExRedmond all'utente con nome visualizzato Davide Garghentini.

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

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

In questo esempio viene assegnato il criterio di segreteria telefonica ospitata con valore Identity ExRedmond 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-CsHostedVoicemailPolicy, che assegna il criterio ExRedmond a ognuno di questi utenti.