Compartir a través de

  • Artículo

Set-CsUserServicesConfiguration

 

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

Modifica una recopilación existente de opciones de configuración de Servicios de usuarios. El Servicios de usuario se usa para ayudar a mantener información de presencia y administrar conferencias.

Sintaxis

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>]]

Descripción detallada

Microsoft Lync Server 2010 confía en el servicio Servicios de usuario para ayudar a mantener la información de presencia para los usuarios y administrar las reuniones y las conferencias. A su vez, los cmdlets CsUserServicesConfiguration se usan para administrar las opciones de configuración de los 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 de usuario es el propio servicio de Servicios de usuario). Esta configuración permite determinar aspectos como la cantidad de contactos que un usuario puede tener; la cantidad de reuniones que un usuario puede haber programado en un momento dado y el tiempo durante el cual determinada reunión puede permanecer activa.

El cmdlet Set-CsUserServicesConfiguration ofrece una manera para que los administradores modifiquen información sobre algunas (o todas) las opciones de configuración de Servicios de usuario que están actualmente en uso.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsUserServicesConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las opciones de configuración de Servicios de usuario que se modificarán. Para modificar la configuración global, use esta sintaxis: -Identity global. Para modificar las configuraciones establecidas en el ámbito de sitio, use una sintaxis similar a esta: -Identity site:Redmond. Para modificar las configuraciones en el nivel de servicio, use una sintaxis similar a esta: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Instance

Opcional

Objeto UserServicesSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

AnonymousUserGracePeriod

Opcional

TimeSpan

Representa la cantidad de horas que un usuario anónimo (no autenticado) puede permanecer en una reunión sin que un usuario autenticado esté presente en la misma reunión. Por ejemplo, si este valor se define en 15 minutos, un usuario anónimo puede estar en la reunión, como máximo, 15 minutos antes de que un usuario autenticado deba unirse. Si el usuario autenticado no se une antes de que expire el periodo de gracia, se quitará al usuario anónimo de la reunión. Esta configuración afecta a las reuniones programadas y a las ad hoc que se hayan creado mediante la opción Reunirse ahora de Microsoft Lync.

AnonymousUserGracePeriod debe especificarse con el siguiente formato: días.minutos:segundos (por ejemplo, 0.00:30:00 para 30 minutos). El periodo de gracia se puede establecer en cualquier valor entre 0 segundo y 1 día; el valor predeterminado es 90 minutos (01:30:00).

DeactivationGracePeriod

Opcional

TimeSpan

El periodo de tiempo máximo que una reunión puede permanecer activa. Este valor debe especificarse con el siguiente formato: días.horas:minutos:segundos. Por ejemplo, para permitir que una reunión dure 60 horas, debe usar este formato: 2.12:00:00 (2 días: 12 horas: 00 minutos: 00 segundos).

DeactivationGracePeriod debe ser entre 8 horas y 365 días, inclusive. El valor predeterminado es 1 día.

DefaultSubscriptionExpiration

Opcional

Integer

Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, tal como información de presencia. Cuando se realiza una solicitud, el usuario (o, mejor dicho, la aplicación de cliente del usuario) puede solicitar el periodo de tiempo para que la suscripción sea válida antes de que se renueve. Si no se envía dicha solicitud, la suscripción se establece en el valor especificado por la propiedad DefaultSubscriptionExpiration.

El tiempo de suscripción predeterminado debe expresarse como un valor entero entre 300 segundos (5 minutos) y 86400 segundos (24 horas), inclusive. El valor predeterminado es 28800 segundos (8 horas).

MaintenanceTimeOfDay

Opcional

DateTime

Indica la hora del día en que se lleva a cabo el mantenimiento de la base de datos programada periódicamente (tal como la purga de registros desactualizados). Este valor debe especificarse como un valor de fecha y hora; puede usar el formato de 24 horas (por ejemplo, "14:00") o bien el formato de 12 horas (por ejemplo, "2:00 PM").

El valor predeterminado de MaintenanceTimeOfDay es 1:00 AM (01:00:00).

MaxContacts

Opcional

Integer

La cantidad máxima de contactos que puede tener un usuario; el valor predeterminado es 250. La propiedad MaxContacts representa la cantidad máxima absoluta de contactos que puede tener un usuario. No obstante, puede usar los cmdlets CsClientPolicy para limitar a determinados usuarios a una cantidad máxima de contactos inferior al valor de MaxContacts.

MaxPersonalNotes

Opcional

Integer

Indica la cantidad máxima de notas personales que se almacenan en el historial de notas del usuario. De manera predeterminada, en el historial de notas se guardan las 3 últimas notas personales. La cantidad máxima de notas que se pueden mantener en el historial es 10.

MaxScheduledMeetingsPerOrganizer

Opcional

Integer

La cantidad máxima de reuniones que un usuario único puede atender como organizador en una hora dada. El valor predeterminado es 1000. Esto significa que, si un usuario ya ha organizado 1.000 reuniones, su solicitud para programar una nueva reunión (reunión número 1.001) generará un error.

MaxSubscriptionExpiration

Opcional

Integer

Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, tal como información de presencia. Cuando se realiza una solicitud, el usuario (o, mejor dicho, la aplicación de cliente del usuario) puede solicitar el periodo de tiempo para que la suscripción sea válida antes de que se renueve. La propiedad MaxSubscriptionExpiration representa una cantidad máxima de tiempo que el cliente puede obtener. Por ejemplo, si el tiempo máximo se define en 28800 segundos y el cliente solicita un intervalo de tiempo de espera de 86400 segundos, el cliente tendrá el periodo de expiración máximo permitido: 28800 segundos.

El tiempo de suscripción máxima debe expresarse como un valor entero entre 300 segundos (5 minutos) y 86400 segundos (24 horas), inclusive. El valor predeterminado es 43200 segundos (12 horas).

MaxSubscriptions

Opcional

Integer

La cantidad máxima de diálogos de suscripción de SIP que un usuario puede tener abierto en un momento dado. Un diálogo de suscripción representa una solicitud para los recursos de SIP.

MinSubscriptionExpiration

Opcional

Integer

Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, tal como información de presencia. Cuando se realiza una solicitud, el usuario (o, mejor dicho, la aplicación de cliente del usuario) puede solicitar el periodo de tiempo para que la suscripción sea válida antes de que se renueve. La propiedad MinSubscriptionExpiration representa una cantidad mínima de tiempo que el cliente puede obtener. Por ejemplo, si el tiempo mínimo se define en 1200 segundos y el cliente solicita un intervalo de tiempo de espera de 200 segundos, el cliente tendrá el periodo de expiración mínimo permitido: 1200 segundos.

El tiempo de suscripción mínimo debe expresarse como un valor entero entre 300 segundos (5 minutos) y 86400 segundos (24 horas), inclusive. El valor predeterminado es 1200 segundos (20 minutos).

SubscribeToCollapsedDG

Opcional

Booleano

Cuando se configura el valor True (el valor predeterminado), las aplicaciones cliente podrán suscribirse en grupos de distribución que no estén expandidos en ese momento en la lista de contactos. Esto permite al cliente mantener la información de presencia actualizada para todos los miembros del grupo. Si se define en False, las aplicaciones de cliente no se permitirán para los grupos “contraídos”.

Force

Opcional

Parámetro modificador

Evita que se muestre cualquier mensaje de error no grave que pueda surgir cuando se ejecuta el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings. Set-CsUserServicesConfiguration acepta instancias canalizadas del objeto de configuración de servicios de usuario.

Tipos de valores devueltos

Set-CsUserServicesConfiguration no devuelve valores ni objetos. En cambio, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Ejemplo

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

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

En el comando que se muestra en el Ejemplo 1 modifica las opciones de configuración de Servicios de usuario para el sitio de Redmond (-Identity site:Redmond). En este ejemplo, AnonymousUserGracePeriod se establece en 30 minutos (00 horas: 30 minutos: 00 segundos).

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

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

En el Ejemplo 2, la propiedad MaintenanceTimeOfDay se modifica para las opciones de configuración de Servicio de usuario aplicadas al sitio Redmond. Esta acción se lleva a cabo por medio del parámetro MaintenanceTimeOfDay y el valor de parámetro 13:30. Eso establece la hora del día para el mantenimiento en 1:30 p. m. (13 horas y 30 minutos según el formato de 24 horas).

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

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

El comando anterior recupera las opciones de configuración de Servicios de usuario aplicadas en el ámbito de servicio y, luego, modifica la cantidad de contactos permitida para cada uno de estos elementos. Para llevar a cabo esta tarea, el comando primero usa Get-CsUserServicesConfiguration y el parámetro Filter para recuperar todas las configuraciones que se hayan aplicado en el ámbito de servicio; el valor de filtro "service:*" limita los datos devueltos a las configuraciones que tengan un parámetro de Identity que comience con los caracteres "service:". Luego, esta recopilación filtrada se transfiere a Set-CsUserServicesConfiguration, que toma cada elemento de la recopilación y establece la propiedad MaxContacts en 300.

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

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

En el Ejemplo 4, se modifican todas las opciones de configuración de Servicios de usuario que permiten que los usuarios tengan más de 300 contactos; después de que se realizan las modificaciones, ninguna configuración permitirá más de 300 contactos. Para llevar a cabo esta acción, el comando primero llama a Get-CsUserServicesConfiguration sin ningún parámetro adicional. Esto devuelve una recopilación de todas las opciones de configuración de Servicios de usuario que se encuentran actualmente en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona sólo esas configuraciones en las que la propiedad MaxContacts es mayor a 300. A su vez, la recopilación filtrada se redirecciona a Set-CsUserServicesConfiguration, que toma cada elemento de la recopilación filtrada y cambia la cantidad máxima de contactos permitidos a 300.