Condividi tramite

  • Articolo

Set-CsUserServicesConfiguration

 

Ultima modifica dell'argomento: 2012-04-23

Consente di modificare una raccolta di impostazioni di configurazione di Servizi utente. Il servizio Servizi utente viene utilizzato per conservare le informazioni sulla presenza e gestire le conferenze.

Sintassi

Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 utilizza il servizio Servizi utente per mantenere le informazioni sulla presenza degli utenti e per gestire le riunioni e le conferenze. A loro volta, i cmdlet CsUserServicesConfiguration vengono utilizzati per gestire le impostazioni di configurazione di Servizi utente nell'ambito globale, del sito e del servizio. Si noti che l'unico servizio in grado di ospitare le impostazioni di configurazione di Servizi utente è il servizio stesso. Queste impostazioni consentono di specificare criteri quali il numero di contatti che un utente può avere; il numero di riunioni pianificate che un utente può avere in un dato momento; il tempo massimo in cui una data riunione può rimanere attiva.

Il cmdlet Set-CsUserServicesConfiguration consente agli amministratori di modificare le informazioni relative a una o più impostazioni di configurazione di Servizi utente attualmente in uso.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsUserServicesConfiguration 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-CsUserServicesConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco delle impostazioni di configurazione di Servizi utente da modificare. Per modificare le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per modificare le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Per modificare le impostazioni a livello di servizio, utilizzare una sintassi simile alla seguente: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Instance

Facoltativo

Oggetto UserServicesSettings

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

AnonymousUserGracePeriod

Facoltativo

Durata

Indica la quantità di tempo in cui un utente anonimo (non autenticato) può rimanere in una riunione senza che alla stessa riunione sia presente un utente autenticato. Se, ad esempio, questo valore è impostato su 15 minuti, un utente anonimo può rimanere nella riunione al massimo per 15 minuti prima che sia necessario che un utente autenticato partecipi alla stessa riunione. Se un utente autenticato non prende parte alla riunione prima della scadenza del periodo di tolleranza, l'utente anonimo verrà rimosso dalla riunione. Questa impostazione si applica sia alle riunioni pianificate che alle riunioni ad hoc create facendo clic su Riunione immediata in Microsoft Lync.

Il valore della proprietà AnonymousUserGracePeriod deve essere specificato nel seguente formato: giorni.minuti:secondi (ad esempio, 0.00:30:00 per indicare 30 minuti). Il periodo di tolleranza può essere impostato su un valore qualunque compreso tra 0 secondi e 1 giorno; il valore predefinito è 90 minuti (01:30:00).

DeactivationGracePeriod

Facoltativo

Durata

La quantità massima di tempo in cui una riunione può rimanere attiva. Questo valore deve essere specificato nel seguente formato: giorni.ore:minuti:secondi. Ad esempio, per indicare che una riunione deve rimanere attiva per 60 ore si utilizza il seguente formato: 2.12:00:00 (2 giorni: 12 ore: 00 minuti: 00 secondi).

Il valore della proprietà DeactivationGracePeriod deve essere compreso tra 8 ore e 365 giorni, inclusi. Il valore predefinito è 1 giorno.

DefaultSubscriptionExpiration

Facoltativo

Numero intero

Ogni volta che un utente effettua una richiesta di dati, come, ad esempio, le informazioni sulla presenza, vengono create delle sottoscrizioni. Quando la richiesta viene effettuata, l'utente, o più correttamente l'applicazione client dell'utente, può richiedere la durata del periodo di validità della sottoscrizione prima che sia necessario rinnovarla. Se non viene effettuata alcuna richiesta, la sottoscrizione viene impostata sul valore specificato dalla proprietà DefaultSubscriptionExpiration.

La durata minima predefinita della sottoscrizione deve essere espressa come numero intero compreso tra 300 secondi (5 minuti) e 86400 secondi (24 ore), inclusi. Il valore predefinito è 28800 secondi (8 ore).

MaintenanceTimeOfDay

Facoltativo

Data/ora

Indica l'ora in cui viene effettuata la manutenzione del database pianificata su base regolare, ad esempio, la cancellazione dei record obsoleti. Questo valore deve essere specificato come data-ora, con la possibilità di scegliere tra il formato 24 ore (ad esempio, "14:00") e il formato 12 ore (in uso nel mondo anglosassone, ad esempio, "2:00 PM").

Il valore predefinito per MaintenanceTimeOfDay è 1:00 AM (01:00:00).

MaxContacts

Facoltativo

Numero intero

Il numero massimo di contatti che un utente può avere; il valore predefinito è 250. La proprietà MaxContacts esprime il numero massimo assoluto di contatti che un utente può avere. Tuttavia, è possibile utilizzare i cmdlet CsClientPolicy per specificare, per determinati utenti, un numero massimo di contatti inferiore a quello impostato in MaxContacts.

MaxPersonalNotes

Facoltativo

Numero intero

Indica il numero massimo di note personali memorizzate nella cronologia note dell'utente. Per impostazione predefinita, le ultime 3 note personali vengono conservate nella cronologia note. Il numero massimo di note che possono essere conservate nella cronologia è 10.

MaxScheduledMeetingsPerOrganizer

Facoltativo

Numero intero

Il numero massimo di riunioni per le quali un singolo utente può fungere da organizzatore a una data ora. Il valore predefinito è 1000. Ciò significa che se un utente è già l'organizzatore di 1000 riunioni, la sua richiesta di pianificare una nuova riunione (la numero 1001) avrà esito negativo.

MaxSubscriptionExpiration

Facoltativo

Numero intero

Ogni volta che un utente effettua una richiesta di dati, come, ad esempio, le informazioni sulla presenza, vengono create delle sottoscrizioni. Quando la richiesta viene effettuata, l'utente, o più correttamente l'applicazione client dell'utente, può richiedere la durata del periodo di validità della sottoscrizione prima che sia necessario rinnovarla. La proprietà MaxSubscriptionExpiration esprime la durata massima del periodo di concessione dei client. Ad esempio, se la durata massima è impostata su 28800 secondi e il client richiede un intervallo di timeout pari a 86400 secondi, al client verrà assegnato il periodo di validità massimo consentito: 28800 secondi.

La durata massima della sottoscrizione deve essere espressa come numero intero compreso tra 300 secondi (5 minuti) e 86400 secondi (24 ore), inclusi. Il valore predefinito è 43200 secondi (12 ore).

MaxSubscriptions

Facoltativo

Numero intero

Il numero massimo di finestre di dialogo di sottoscrizione SIP che un utente può tenere simultaneamente aperte. Una finestra di dialogo di sottoscrizione rappresenta una richiesta di risorse SIP.

MinSubscriptionExpiration

Facoltativo

Numero intero

Ogni volta che un utente effettua una richiesta di dati, come, ad esempio, le informazioni sulla presenza, vengono create delle sottoscrizioni. Quando la richiesta viene effettuata, l'utente, o più correttamente l'applicazione client dell'utente, può richiedere la durata del periodo di validità della sottoscrizione prima che sia necessario rinnovarla. La proprietà MinSubscriptionExpiration esprime la durata minima del periodo di concessione dei client. Ad esempio, se la durata minima è impostata su 1200 secondi e il client richiede un intervallo di timeout pari a 200 secondi, al client verrà assegnato il periodo di validità minimo consentito: 1200 secondi.

La durata minima della sottoscrizione deve essere espressa come numero intero compreso tra 300 secondi (5 minuti) e 86400 secondi (24 ore), inclusi. Il valore predefinito è 1200 secondi (20 minuti).

SubscribeToCollapsedDG

Facoltativo

Booleano

Se impostato su True (il valore predefinito), alle applicazioni client sarà consentito di iscriversi ai gruppi di distribuzione attualmente non espansi nell'elenco dei contatti. Ciò consente al client di conservare informazioni sulla presenza di ciascun membro del gruppo aggiornate al minuto. Se impostato su False, alle applicazioni client non verrà consentito di iscriversi ai gruppi "compressi".

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.Settings.UserServices.UserServicesSettings. Set-CsUserServicesConfiguration accetta istanze inviate tramite pipeline dell'oggetto impostazioni di configurazione di Servizi utente.

Tipi restituiti

Set-CsUserServicesConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Esempio

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

Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"

Il comando riportato nell'Esempio 1 consente di modificare le impostazioni di configurazione di Servizi utente per il sito Redmond (-Identity site:Redmond). In questo esempio, il valore di AnonymousUserGracePeriod è impostato su 30 minuti (00 ore: 30 minuti: 00 secondi).

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

Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"

Nell'Esempio 2, nelle impostazioni di configurazione di Servizi utente applicate al sito Redmond viene modificata la proprietà MaintenanceTimeOfDay. Per ottenere questo risultato, il parametro MaintenanceTimeOfDay viene, ad esempio, impostato su 13:30 e di conseguenza questa sarà l'ora in cui verrà eseguita la manutenzione.

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

Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300

Il comando precedente recupera tutte le impostazioni di configurazione di Servizi utente applicate nell'ambito del servizio e quindi modifica il numero massimo di contatti consentiti per ciascuno di questi elementi. Per eseguire questa operazione, il comando utilizza il cmdlet Get-CsUserServicesConfiguration e il parametro Filter per recuperare tutte le impostazioni configurate nell'ambito del servizio; il valore del filtro "service:*" restituisce solo i dati relativi alle impostazioni la cui identità inizia con "service:". Questa raccolta filtrata viene quindi inviata al cmdlet Set-CsUserServicesConfiguration che imposta su 300 la proprietà MaxContacts per ogni singolo elemento nella raccolta.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 300} | Set-CsUserServicesConfiguration -MaxContacts 300

Nell'Esempio 4, vengono modificate tutte le impostazioni di configurazione di Servizi utente che consentono agli utenti di avere più di 300 contatti; dopo questa modifica, nessuna impostazione consentirà di avere più di 300 contatti. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsUserServicesConfiguration senza parametri aggiuntivi. Si ottiene così una raccolta di tutte le impostazioni di configurazione di Servizi utente attualmente in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà MaxContacts è maggiore di 300. La raccolta filtrata viene a sua volta inviata tramite pipe al cmdlet Set-CsUserServicesConfiguration che imposta su 300 il numero massimo di contatti consentiti per ogni singolo elemento nella raccolta filtrata.