Condividi tramite

  • Articolo

Get-CsUserServicesConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle impostazioni di configurazione dei servizi utente in uso nell'organizzazione. Il servizio Servizi utente consente di conservare le informazioni sulla presenza e gestire le conferenze online.

Sintassi

Get-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUserServicesConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Microsoft Lync Server 2010 fa affidamento sul servizio Servizi utente per mantenere le informazioni sulla presenza degli utenti e per gestire le riunioni e le conferenze. I cmdlet CsUserServicesConfiguration vengono a loro volta utilizzati per gestire le impostazioni di Servizi utente nell'ambito del servizio, del sito e globale. L'unico servizio che può ospitare le impostazioni di configurazione di Servizi utente è il servizio Servizi utente stesso. Queste impostazioni aiutano a determinare, tra le altre cose, il numero di contatti massimo per un utente, il numero di riunioni che un utente può pianificare in un dato momento e la lunghezza del periodo di attività di una data riunione.

Il cmdlet Get-CsUserServicesConfiguration offre agli amministratori un mezzo per recuperare informazioni su una o su tutte le impostazioni di configurazione del servizio Servizi utente attualmente in uso.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsUserServicesConfiguration in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Get-CsUserServicesConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

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

Se il parametro viene omesso, Get-CsUserServicesConfiguration restituisce tutte le impostazioni di configurazione di Servizi utente attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per il recupero di una o più raccolte di impostazioni di configurazione di Servizi utente. Ad esempio, per restituire tutte le impostazioni configurate nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Per restituire tutte le impostazioni configurate nell'ambito del servizio, utilizzare la seguente sintassi: -Filter "service:*".

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione di Servizi utente dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsUserServicesConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsUserServicesConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Esempio

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

Get-CsUserServicesConfiguration

Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutte le impostazioni di configurazione di Servizi utente attualmente in uso nell'organizzazione. Questo risultato viene ottenuto chiamando Get-CsUserServicesConfiguration senza alcun parametro aggiuntivo.

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

Get-CsUserServicesConfiguration -Identity site:Redmond

Con l'esempio 2 viene restituita una sola raccolta di impostazioni di configurazione di Servizi utente, quella con identità site:Redmond. Poiché le identità devono essere univoche, il comando non restituirà mai più di un elemento.

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

Get-CsUserServicesConfiguration -Filter "service:*"

Con l'esempio 3 viene restituita una raccolta di tutte le impostazioni di configurazione di Servizi utente applicate nell'ambito del servizio. Questa operazione viene eseguita chiamando Get-CsUserServicesConfiguration con il parametro -Filter; il valore del filtro "service:*" limita i dati restituiti alle impostazioni in cui l'identità inizia con i caratteri "service:". Per definizione, si tratta delle impostazioni configurate nell'ambito del servizio.

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

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

Con il comando precedente vengono restituite tutte le impostazioni di configurazione di Servizi utente che permettono agli utenti di avere più di 250 contatti. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsUserServicesConfiguration senza parametri aggiuntivi per restituire una raccolta di tutte le impostazioni di configurazione di Servizi utente attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà MaxContacts è maggiore di 250.

-------------------------- Esempio 5 --------------------------

Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}

Con l'esempio 5 vengono riportate le informazioni per quelle impostazioni di configurazione di Servizi utente in cui il periodo di tolleranza per gli utenti anonimi è superiore a 10 minuti. Per eseguire questa attività, il comando chiama per prima cosa Get-CsUserServicesConfiguration senza parametri aggiuntivi per restituire una raccolta di tutte le impostazioni di configurazione di Servizi utente in uso nell'organizzazione. La raccolta restituita viene quindi inviata tramite pipe a Where-Object, che seleziona solo le impostazioni in cui la proprietà AnonymousUserGracePeriod è maggiore di 10 minuti (00 ore: 10 minuti: 00 secondi).