Condividi tramite

  • Articolo

New-CsPresencePolicy

 

Ultima modifica dell'argomento: 2012-03-25

Crea un nuovo criterio di presenza nell'ambito del sito o nell'ambito per utente.

Sintassi

New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-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 di gestire due aspetti importanti delle sottoscrizioni relative alla 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. Finché non viene chiusa la 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.

Nelle versioni precedenti a Microsoft Lync Server 2010 le richieste di sottoscrizione e le sottoscrizioni alle categorie vengono gestite globalmente. Grazie ai cmdlet CsPresencePolicy, attualmente è possibile gestire le sottoscrizioni relative alla presenza nell'ambito globale, del sito o 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 New-CsPresencePolicy consente di creare criteri di presenza personalizzati nell'ambito del sito o nell'ambito per utente. I criteri creati nell'ambito del sito vengono applicati automaticamente al sito in questione. I criteri dell'ambito per utente invece devono essere assegnati ai diversi utenti eseguendo il cmdlet Grant-CsPresencePolicy. Si noti che non è possibile creare un nuovo criterio di presenza nell'ambito globale, né un secondo criterio di presenza a un sito. Ad esempio, il sito Redmond può ospitare solo un criterio di presenza.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsPresencePolicy i membri dei seguenti gruppi: 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 "New-CsPresencePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Identità XDS

Identificatore univoco per il nuovo criterio di presenza. Per creare un nuovo criterio per utente, utilizzare la sintassi: -Identity "RedmondPresencePolicy". Per creare un nuovo criterio nell'ambito del sito, utilizzare la sintassi: -Identity "site:Redmond".

Si noti che non è possibile creare un nuovo criterio di presenza nell'ambito globale. Inoltre, il comando non funziona, se il sito in questione ospita già un criterio di presenza o se si tenta di utilizzare l'identità di un criterio per utente già esistente.

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

Numero massimo di sottoscrizioni alla categoria consentito in un dato momento. Una sottoscrizione alla categoria rappresenta una richiesta per una categoria specifica di informazioni, ad esempio, un'applicazione che richiede i dati del calendario.

È possibile impostare MaxCategorySubscription su qualsiasi valore integer compreso fra 0 e 3000; il valore predefinito è 1000.

MaxPromptedSubscriber

Facoltativo

Numero intero

Il numero massimo di sottoscrittori con richiesta che un utente può avere in un dato momento. Per impostazione predefinita, ogni volta che un utente viene aggiunto all'elenco contatti di un altro utente, ne viene informato tramite notifica e può scegliere se eseguire operazioni quali aggiungere l'altro utente al proprio elenco contatti o bloccare la visualizzazione della propria presenza. Fino a quando non si esegue un'azione e si chiude la richiesta della finestra di dialogo, ogni notifica vale come un sottoscrittore con richiesta.

È possibile impostare MaxPromptedSubscriber su qualsiasi numero intero compreso tra 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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno. New-CsPresencePolicy non accetta l'input da pipeline.

Tipi restituiti

New-CsPresencePolicy crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Esempio

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

New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500

Il comando mostrato nell'esempio 1 consente di creare un nuovo criterio di presenza per utente con Identity RedmondPresencePolicy. In questo esempio il valore della proprietà MaxPromptedSubscriber è impostato su 400 e il valore della proprietà MaxCategorySubscription su 500.

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

$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x

Nell'esempio 2, inizialmente, viene creato un nuovo criterio di presenza per utente in memoria e, solo in un secondo momento, questo viene convertito in un criterio di presenza effettivo. A tale scopo, il primo comando dell'esempio crea un criterio di presenza con Identity RedmondPresencePolicy e archivia il criterio in una variabile denominata $x. Il parametro InMemory garantisce che il criterio venga creato unicamente in memoria e che non venga aggiunto immediatamente a Lync Server 2010.

I comandi 2 e 3 vengono utilizzati successivamente per configurare le proprietà MaxPromptedSubscriber e MaxCategorySubscription del criterio virtuale. Una volta impostati i valori del criterio, nella riga 4 viene utilizzato Set-CsPresencePolicy con il parametro Instance per creare un criterio di presenza effettivo in base alle informazioni archiviate in $x. Il passaggio successivo è fondamentale: se non si chiama Set-CsPresencePolicy, il criterio sarà presente solo nella memoria e verrà eliminato non appena si chiude la sessione di Windows PowerShell o si elimina la variabile $x.