Condividi tramite

  • Articolo

Set-CsPresencePolicy

 

Ultima modifica dell'argomento: 2012-03-25

Consente di modificare un criterio di presenza esistente.

Sintassi

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le informazioni sulla presenza, che, tra l'altro, consentono di verificare se un contatto è disponibile per partecipare a una conversazione di messaggistica istantanea, sono fondamentali. Tuttavia, è necessario tenere conto del costo associato alle informazioni sulla presenza: tanto maggiore è il numero di sottoscrizioni relative alla presenza, tanto maggiore sarà la larghezza di banda che è necessario dedicare all'aggiornamento di queste informazioni. Se la larghezza di banda rappresenta una preoccupazione, può essere opportuno limitare il numero di sottoscrizioni relative alla presenza per ogni utente.

I cmdlet CsPresencePolicy consentono di gestire due aspetti importanti legati alle sottoscrizioni relative alla presenza: sottoscrittori richiedenti e sottoscrittori di categoria. 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 a quando non si chiude la finestra pop-up, ogni notifica vale come sottoscrittore richiedente. La proprietà MaxPromptedSubscriber del criterio di presenza consente di specificare il numero massimo di notifiche non risolte consentite per ogni utente. Se un utente raggiunge il numero massimo di notifiche consentite, non ne riceverà più fino a quando non risolve alcune di queste già ricevute.

Le sottoscrizioni di categoria rappresentano una richiesta per una specifica categoria di informazioni (ad esempio, un'applicazione che richiede dati del calendario). La proprietà MaxCategorySubscription consente agli amministratori di stabilire un limite al numero di sottoscrizioni di categoria che un utente può avere.

Nelle versioni precedenti a Microsoft Lync Server 2010, la gestione dei sottoscrittori richiedenti e dei sottoscrittori di categoria veniva eseguita a livello globale. Con i cmdlet CsPresencePolicy, è ora possibile gestire le sottoscrizioni richiedenti nell'ambito globale, del sito e persino del singolo utente. In questo modo, è possibile controllare l'utilizzo della larghezza di banda e, nel contempo, consentire agli utenti di accedere alle informazioni sulla presenza di cui necessitano per il loro lavoro.

Il cmdlet Set-CsPresencePolicy consente di modificare qualunque criterio di presenza configurato per l'utilizzo nella propria organizzazione. Modificare un criterio di presenza significa impostare un diverso valore per la proprietà MaxPromptedSubscriber e/o la proprietà MaxCategorySubscription.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsPresencePolicy può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPresencePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identificatore univoco del criterio di presenza da modificare. Per modificare il criterio globale, utilizzare la seguente sintassi: -Identity global. Per modificare un criterio nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per modificare un criterio a livello di singolo utente, utilizzare una sintassi simile alla seguente: -Identity "RedmondPresencePolicy".

Instance

Facoltativo

Oggetto criterio di presenza

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Description

Facoltativo

Stringa

Consente agli amministratori di fornire un testo aggiuntivo da associare a un criterio di presenza. Il parametro Description potrebbe ad esempio includere informazioni sugli utenti a cui assegnare il criterio.

MaxCategorySubscription

Facoltativo

Numero intero

Il numero massimo di sottoscrizioni di categoria che un utente può avere in qualunque momento. Le sottoscrizioni di categoria rappresentano una richiesta per una specifica categoria di informazioni (ad esempio, un'applicazione che richiede dati del calendario).

La proprietà MaxCategorySubscription può essere impostata su qualsiasi numero intero compreso tra 0 e 3000; il valore predefinito è 1000.

MaxPromptedSubscriber

Facoltativo

Numero intero

Numero massimo di richieste di sottoscrizione che un utente può avere in qualunque momento. Per impostazione predefinita, ogni volta che un utente viene aggiunto all'elenco contatti di un altro utente, viene visualizzata la relativa finestra di dialogo di notifica che consente di eseguire operazioni come aggiungere la persona al proprio elenco contatti o bloccare tale persona e non consentirle di visualizzare la propria presenza. Fino a quando non si sceglie come procedere e non si chiude la finestra di dialogo, ogni notifica conta come una richiesta di sottoscrizione.

È possibile impostare MaxPromptedSubscriber su qualsiasi valore di tipo integer compreso fra 0 e 600, inclusi; il valore predefinito è 200. Se si imposta il valore su 0, gli utenti non riceveranno alcuna notifica quando vengono aggiunti all'elenco contatti di un altro utente.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy. Set-CsPresencePolicy accetta l'input tramite pipeline dell'oggetto criterio di presenza.

Tipi restituiti

Set-CsPresencePolicy non restituisce alcun oggetto o valore. Il cmdlet configura invece istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Esempio

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

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

Il comando riportato nell'Esempio 1 consente di modificare il criterio di presenza RedmondPresencePolicy per un singolo utente. In questo esempio, il valore della proprietà MaxPromptedSubscriber è impostato su 300.

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

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

Il comando riportato nell'Esempio 2 è una variante del comando riportato nell'Esempio 1; in questo caso, però, la proprietà MaxPromptedSubscriber è impostata su 300 per tutti i criteri di presenza configurati per l'utilizzo nell'organizzazione. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsPresencePolicy senza alcun parametro; ciò restituisce una raccolta di tutti i criteri di presenza configurati per l'utilizzo nell'organizzazione. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsPresencePolicy che imposta il valore della proprietà MaxPromptedSubscriber di ciascun criterio della raccolta su 300.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

L'Esempio 3 mostra come configurare i criteri di presenza nell'organizzazione in modo che nessun criterio consenta più di 300 sottoscrittori richiedenti. Per ottenere questo risultato, il comando prima utilizza il cmdlet Get-CsPresencePolicy senza alcun parametro in modo da ottenere una raccolta di tutti i criteri di presenza nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Objectche seleziona solo quei criteri in cui la proprietà MaxPromptedSubscriber è maggiore di (-gt) 300. La raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Set-CsPresencePolicy che, per ciascun criterio della raccolta, imposta il numero massimo di sottoscrittori richiedenti su 300. Di conseguenza, nessun criterio consentirà più di 300 sottoscrittori richiedenti; alcuni criteri potrebbero consentire un numero di sottoscrittori inferiore a 300.