Condividi tramite

  • Articolo

Grant-CsPresencePolicy

 

Ultima modifica dell'argomento: 2012-03-23

Concede un criterio di presenza per utente a un utente o a un gruppo di utenti.

Sintassi

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

Descrizione dettagliata

Le informazioni sulla presenza (che, tra l'altro, indicano se un contatto è disponibile a partecipare a una conversazione di messaggistica istantanea) sono di estrema importanza. Allo stesso tempo, tuttavia, le informazioni sulla presenza comportano un costo: maggiore è il numero delle sottoscrizioni di presenza, maggiore sarà la larghezza di banda da dedicare all'aggiornamento delle informazioni sulla presenza. Se la larghezza di banda rappresenta un problema, è possibile limitare il numero di sottoscrizioni di presenza disponibili per ciascun utente.

I cmdlet CsPresencePolicy consentono la gestione di due aspetti importanti delle sottoscrizioni di presenza: richieste di sottoscrizione e sottoscrizioni alle categorie. Quando si viene aggiunti all'elenco contatti di un'altra persona in Microsoft Lync 2010, il comportamento predefinito prevede la ricezione di una notifica popup in cui si viene informati che si è stati aggiunti al suddetto elenco. Fino alla chiusura della finestra popup visualizzata, ogni notifica viene considerata una richiesta di sottoscrizione. La proprietà MaxPromptedSubscriber del criterio di presenza consente di specificare il numero massimo di finestre di dialogo non risolte per ogni utente. Una volta raggiunto il numero massimo consentito, l'utente non riceverà nuove notifiche di contatto, almeno fino alla risoluzione di alcune delle finestre di dialogo.

Le sottoscrizioni alle categorie rappresentano la richiesta di una categoria di informazioni specifica. Ad esempio, un'applicazione che richiede i dati del calendario. La proprietà MaxCategorySubscription consente agli amministratori di definire un limite per il numero di sottoscrizioni alle categorie disponibili per un utente.

Prima della versione Microsoft Lync Server 2010, le richieste di sottoscrizione e le sottoscrizioni alle categorie erano gestite globalmente. Grazie ai cmdlet CsPresencePolicy, attualmente è possibile gestire le sottoscrizioni di presenza nell'ambito globale, nell'ambito del sito o anche nell'ambito per utente. In questo modo è possibile controllare l'utilizzo della larghezza di banda e, contemporaneamente, garantire l'accesso degli utenti alle informazioni sulla presenza necessarie per le proprie attività.

Quando si crea un criterio per utente, il criterio non viene automaticamente assegnato a nessuno. I criteri di presenza per utente devono invece essere assegnati esplicitamente agli utenti (o ai gruppi di utenti) eseguendo il cmdlet Grant-CsPresencePolicy.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Indica l'identità dell'account utente a cui assegnare il criterio di presenza. Le identità utente possono essere specificate utilizzando 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). Le identità utente possono essere specificate anche utilizzando il nome distinto dell'utente in Active Directory.

È inoltre possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come valore Identity dell'utente. L'identità "* Smith" restituisce ad esempio tutti gli utenti con un nome visualizzato che termina con il valore stringa "Smith".

PolicyName

Obbligatorio

Identità del criterio per utente da assegnare, ad esempio: -PolicyName "RedmondPresencePolicy". PolicyName corrisponde all'identità del criterio meno il prefisso "tag:". Ad esempio, un criterio con identità "tag:NorthAmericaPresencePolicy" presenta un PolicyName uguale a "NorthAmericaPresencePolicy".

DomainController

Facoltativo

Nome completo del controller di dominio da contattare durante l'assegnazione dei criteri. Ad esempio: -DomainController atl-dc-001.litwareinc.com.

Se non viene specificato, Grant-CsPresencePolicy contatterà il controller di dominio disponibile più vicino durante l'assegnazione del criterio.

PassThru

Facoltativo

Consente di passare un oggetto utente attraverso la pipeline che rappresenta l'utente a cui viene assegnato il criterio. Per impostazione predefinita, il cmdlet Grant-CsPresencePolicy non passa alcun oggetto attraverso la pipeline.

WhatIf

Facoltativo

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Valore stringa oppure oggetto Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy. Grant-CsPresencePolicy accetta input inviato tramite pipeline di valori stringa che rappresentano l'identità di un account utente. Il cmdlet accetta inoltre input inviato tramite pipeline di oggetti utente.

Tipi restituiti

Per impostazione predefinita, Grant-CsPresencePolicy non restituisce oggetti o valori. Tuttavia, se si include il parametro PassThru, il cmdlet restituisce istanze di Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Esempio

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

Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"

Con il comando mostrato nell'esempio 1 viene assegnato il criterio di presenza per utente RedmondPresencePolicy a un singolo utente, quello con identità Davide Garghentini.

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

Nell'esempio 2 il criterio di presenza RedmondPresencePolicy viene assegnato a tutti gli utenti che dispongono di account nell'unità organizzativa Redmond in Servizi di dominio Active Directory. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsUser e il parametro OU per restituire una raccolta di tutti gli account utente presenti nell'unità organizzativa Redmond (OU=Redmond,dc=litwareinc,dc=com). La raccolta viene quindi inviata tramite pipe a Grant-CsPresencePolicy, che assegna il criterio RedmondPresencePolicy ad ogni utente nella raccolta.

-------------------------- Esempio 3 --------------------------

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

Con il comando precedente viene assegnato il criterio RedmondPresencePolicy a tutti gli utenti che lavorano nella città di Redmond. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsUser e il parametro LDAPFilter per restituire una raccolta degli utenti che lavorano a Redmond; il valore del filtro "l=Redmond" limita i dati restituiti agli utenti di Redmond. Nel linguaggio di query LDAP, l (elle minuscola) è l'abbreviazione di "località" e corrisponde quindi alla città. La raccolta recuperata viene quindi inviata tramite pipe a Grant-CsPresencePolicy, che assegna il criterio RedmondPresencePolicy ad ogni utente nella raccolta.

-------------------------- Esempio 4 --------------------------

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null

Con il comando mostrato nell'esempio 4 viene annullata l'assegnazione di tutti i criteri di presenza per utente precedentemente assegnati agli utenti che lavorano a Redmond. Con una chiamata a Grant-CsPresencePolicy con il parametro PolicyName impostato su un valore null ($Null), il cmdlet rimuove qualsiasi criterio di presenza per utente assegnato agli utenti interessati dal comando.