Get-CsPresencePolicy
Ultima modifica dell'argomento: 2012-05-21
Restituisce informazioni sui criteri di presenza configurati per l'uso in un'organizzazione.
Sintassi
Get-CsPresencePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPresencePolicy [-Filter <String>] [-LocalStore <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à.
Il cmdlet Get-CsPresencePolicy consente di restituire informazioni su tutti i criteri di presenza configurati per l'uso nell'organizzazione.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsPresencePolicy in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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 "Get-CsPresencePolicy"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Identificatore univoco del criterio di presenza da recuperare. Per restituire il criterio globale, utilizzare la sintassi seguente: -Identity global. Per restituire un criterio configurato in ambito sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per restituire un criterio configurato in ambito servizio, utilizzare una sintassi simile alla seguente: -Identity "RedmondPresencePolicy". Non è possibile utilizzare caratteri jolly quando si specifica l'identità. Se non vengono specificati né il parametro Identity né il parametro Filter, Get-CsPresencePolicy restituisce tutti i criteri di presenza configurati per l'uso nell'organizzazione. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare il criterio o i criteri da restituire. Ad esempio, per ottenere tutti i criteri di presenza configurati nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Non è possibile utilizzare i parametri Filter e Identity nello stesso comando. |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di recuperare i dati dei criteri di presenza dalla replica locale del archivio di gestione centrale anziché dal archivio di gestione centrale stesso. |
Tipi di input
Nessuno. Get-CsPresencePolicy non accetta l'input da pipeline.
Tipi restituiti
Get-CsPresencePolicy restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsPresencePolicy
Con il comando mostrato nell'esempio 1 vengono restituite le informazioni su tutti i criteri di presenza configurati per l'uso nell'organizzazione. Questa operazione viene eseguita chiamando Get-CsPresencePolicy senza alcun parametro.
-------------------------- Esempio 2 ------------------------
Get-CsPresencePolicy -Identity "RedmondPresencePolicy"
Con l'esempio 2 viene restituito un singolo criterio di presenza per utente, quello con identità RedmondPresencePolicy.
-------------------------- Esempio 3 ------------------------
Get-CsPresencePolicy -Filter "site:*"
Con il comando precedente vengono restituite informazioni su tutti i criteri di presenza configurati nell'ambito del sito. Per ottenere questo risultato, il comando utilizza il parametro Filter e il valore del filtro "site:*", che limita i dati restituiti ai criteri di presenza la cui identità inizia con il valore stringa "site:".
-------------------------- Esempio 4 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}
Nell'esempio 4 vengono restituite le informazioni per tutti i criteri di presenza che limitano il numero massimo di richieste di sottoscrizione a 100. Per eseguire questa attività, il comando chiama innanzitutto Get-CsPresencePolicy senza alcun parametro per restituire una raccolta di tutti i criteri di presenza configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object , che seleziona solo i criteri in cui la proprietà MaxPromptedSubscriber è minore o uguale a 100.
Vedere anche
Ulteriori risorse
Grant-CsPresencePolicy
New-CsPresencePolicy
Remove-CsPresencePolicy
Set-CsPresencePolicy