Compartir a través de

  • Artículo

Get-CsUserServicesConfiguration

 

Última modificación del tema: 2012-03-23

Devuelve información acerca de los valores de configuración de Servicios del usuario utilizados en la organización. El servicio Servicios del usuario ayuda a mantener información de presencia y a administrar conferencias.

Sintaxis

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

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

Descripción detallada

Microsoft Lync Server 2010 confía en el servicio Servicios del usuario para ayudar a mantener la información de presencia para los usuarios y a administrar las reuniones y las conferencias. A su vez, los cmdlets CsUserServicesConfiguration se usan para administrar las configuraciones de Servicios de usuario en el ámbito de servicios, del sitio y a nivel global. (Tenga en cuenta que el único servicio que puede hospedar opciones de configuración de Servicios del usuario es el propio servicio Servicios del usuario). Esta configuración permite determinar aspectos como el número de contactos que un usuario puede tener; el número de reuniones que un usuario puede haber programado en un momento dado y el tiempo durante el cual una reunión determinada puede permanecer activa.

El cmdlet Get-CsUserServicesConfiguration proporciona a los administradores un modo para recuperar información acerca de cualquier valor de configuración (o de todos ellos) de Servicios de usuario que se utilice en ese momento.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsUserServicesConfiguration de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de los valores de configuración de Servicios de usuario que se van a devolver. Para devolver la configuración global, use la siguiente sintaxis: -Identity global. Para devolver la configuración definida en el ámbito de sitio, use la sintaxis siguiente: -Identity site:Redmond. Para devolver la configuración del nivel de servicio, use la sintaxis siguiente: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Si omite este parámetro, Get-CsUserServicesConfiguration devuelve todos los valores de configuración de Servicios de usuario que se están utilizando en ese momento en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al recuperar una o varias recopilaciones de valores de configuración de Servicios de usuario. Por ejemplo, para devolver todas las configuraciones definidas en el ámbito de sitio, use la sintaxis: -Filter "site:*". Para devolver todas las configuraciones definidas en el ámbito de servicio, use la sintaxis: -Filter "service:*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de Servicios de usuario de la réplica local del Almacén de administración central, en lugar del Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsUserServicesConfiguration no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsUserServicesConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsUserServicesConfiguration

El comando que aparece en el Ejemplo 1 devuelve una colección de todos los valores de configuración de Servicios de usuario que se están utilizando en ese momento en la organización. Esto se consigue llamando a Get-CsUserServicesConfiguration sin ningún parámetro adicional.

-------------------------- Ejemplo 2 --------------------------

Get-CsUserServicesConfiguration -Identity site:Redmond

En el Ejemplo 2 solo se devuelve una colección de valores de configuración de Servicios de usuario: la colección con el valor Identity site:Redmond. Puesto que las identidades deben ser únicas, este comando nunca devolverá más de un elemento.

-------------------------- Ejemplo 3 --------------------------

Get-CsUserServicesConfiguration -Filter "service:*"

En el Ejemplo 3 se devuelve una colección de todos los valores de configuración de Servicios de usuario que se han aplicado en el ámbito del servicio. Esto se consigue llamando a Get-CsUserServicesConfiguration junto con el parámetro -Filter; el valor de filtro "service:*" limita los datos devueltos a las configuraciones en las que el valor Identity comience por los caracteres "service:". Por definición, esta es la configuración especificada en el ámbito de servicio.

-------------------------- Ejemplo 4 --------------------------

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

El comando anterior devuelve todos los valores de configuración de Servicios de usuario que permiten a los usuarios tener más de 250 contactos. Para ello, en primer lugar el comando llama a Get-CsUserServicesConfiguration sin ningún parámetro adicional para devolver una colección de todos los valores de configuración de Servicios de usuario en uso en ese momento. A continuación, esta colección se transfiere al cmdlet Where-Object, que solo selecciona las configuraciones en las que la propiedad MaxContacts es mayor que 250.

-------------------------- Ejemplo 5 --------------------------

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

En el Ejemplo 5 se notifica información sobre los valores de configuración de Servicios de usuario en los que el periodo de gracia de usuario anónimo es superior a 10 minutos. Para realizar esta tarea, en primer lugar el comando llama a Get-CsUserServicesConfiguration sin ningún parámetro adicional; esto devuelve una colección de todos los valores de configuración de Servicios de usuario que se están utilizando en la organización. A continuación, la colección devuelta se transfiere a Where-Object, que solo selecciona las configuraciones en las que la propiedad AnonymousUserGracePeriod es mayor que 10 minutos (0 horas: 10 minutos: 00 segundos).