New-CsUserServicesConfiguration
Última modificación del tema: 2012-04-23
Crea una nueva colección de opciones de configuración de Servicios de usuarios. El servicio Servicios del usuario se usa para ayudar a mantener información de presencia y administrar conferencias.
Sintaxis
New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 del usuario para ayudar a mantener la información de presencia para los usuarios y administrar las reuniones y las conferencias en línea. A su vez, los cmdlets CsUserServicesConfiguration se usan para administrar las configuraciones de Servicios del 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 New-CsUserServicesConfiguration permite a los administradores crear una colección de opciones de configuración de Servicios del usuario en el ámbito de sitio o de servicio. (No se pueden crear recopilaciones en el ámbito global.) Tenga en cuenta que cualquier sitio o servicio puede hospedar, como mucho, una única colección de opciones de configuración de Servicios del usuario. El comando dará error si intenta crear una configuración para, por ejemplo, el sitio de Redmond, y dicho sitio ya hospeda una colección de opciones de configuración de Servicios del usuario.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsUserServicesConfiguration de forma local: 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUserServicesConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de las opciones de configuración de Servicios del usuario que se van a crear. Para crear una configuración en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Para crear una configuración en el nivel de servicio, use una sintaxis como ésta: -Identity service:UserServer:atl-cs-001.litwareinc.com. |
AnonymousUserGracePeriod |
Opcional |
TimeSpan |
Representa la cantidad de tiempo que un usuario anónimo (no autenticado) puede permanecer en una reunión sin que haya presente un usuario autenticado en la misma reunión. Por ejemplo, si este valor está definido en 15 minutos, un usuario anónimo puede permanecer en la reunión durante, como mucho, 15 minutos antes de que deba unirse un usuario autenticado. Si ningún usuario autenticado se une antes de que expire el período de gracia, el usuario anónimo será expulsado 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 usando el formato siguiente: días.horas:minutos:segundos (por ejemplo, 0.00:30:00 para indicar 30 minutos). El período de gracia se puede establecer en cualquier valor entre 0 segundos y 1 día; el valor predeterminado es 90 minutos (01:30:00). |
DeactivationGracePeriod |
Opcional |
TimeSpan |
La cantidad máxima de tiempo durante la cual puede permanecer activa una reunión. Este valor debe especificarse usando el formato siguiente: días.horas:minutos:segundos. Por ejemplo, para que una reunión dure 60 horas, debería usar este formato: 2.12:00:00 (2 días. 12 horas: 00 minutos: 00 segundos). El valor del parámetro DeactivationGracePeriod debe estar entre 8 horas y 365 días, ambos incluidos. El valor predeterminado es 1 día (1.00:00:00). |
DefaultSubscriptionExpiration |
Opcional |
Entero |
Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, como información de presencia. Cuando se realiza la solicitud, el usuario (o, mejor dicho, la aplicación cliente del usuario) puede solicitar el período de tiempo durante el cual la suscripción sigue siendo válida antes de que tenga que renovarse. Si no se emite 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 28.800 segundos (8 horas). |
MaintenanceTimeOfDay |
Opcional |
DateTime |
Indica la hora del día en que tiene lugar el mantenimiento de base de datos periódico programado (como la depuración de registros no actualizados). Este se debe especificar con un valor de fecha y hora. Se puede utilizar el formato de 24 horas (como en "14:00") o bien el formato de 12 horas (por ejemplo, "2:00 PM"). El valor predeterminado para MaintenanceTimeOfDay es 1:00 AM (01:00:00). |
MaxContacts |
Opcional |
Entero |
El número máximo de contactos que puede tener un usuario; el valor predeterminado es 250. La propiedad MaxContacts indica el número máximo absoluto de contactos que puede tener un usuario. No obstante, puede usar los cmdlets CsClientPolicy para restringir determinados usuarios a un número máximo de contactos inferior al valor de MaxContacts. |
MaxPersonalNotes |
Opcional |
Entero |
Indica el número máximo de notas personales que se almacenan en el historial de notas del usuario. De forma predeterminada, las 3 últimas notas personales se conservan en el historial de notas. El número máximo de notas que se pueden conservar en el historial son 10. |
MaxScheduledMeetingsPerOrganizer |
Opcional |
Entero |
El número máximo de reuniones que un solo usuario puede atender como organizador para una hora determinada. El valor predeterminado es 1000. Esto significa que, si un usuario ya es el organizador de 1.000 reuniones, su intento de programar una nueva reunión (reunión número 1.001) será errónea. |
MaxSubscriptionExpiration |
Opcional |
Entero |
Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, como información de presencia. Cuando se realiza la solicitud, el usuario (o, mejor dicho, la aplicación cliente del usuario) puede solicitar el período de tiempo durante el cual la suscripción sigue siendo válida antes de que tenga que renovarse. La propiedad MaxSubscriptionExpiration representa la cantidad máxima de tiempo que se puede conceder a los clientes. Por ejemplo, si la cantidad máxima de tiempo está definida en 28.800 segundos y un cliente solicita un intervalo de tiempo de espera de 86.400 segundos, se concederá al cliente el período máximo de expiración permitido: 28.800 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 |
Entero |
El número máximo de cuadros de diálogo de suscripción SIP que un usuario puede tener abiertos al mismo tiempo. Un cuadro de diálogo de suscripción representa una solicitud de recursos SIP. El valor predeterminado es 200. |
MinSubscriptionExpiration |
Opcional |
Entero |
Las suscripciones se crean cada vez que un usuario realiza una solicitud de datos, como información de presencia. Cuando se realiza la solicitud, el usuario (o, mejor dicho, la aplicación cliente del usuario) puede solicitar el período de tiempo durante el cual la suscripción sigue siendo válida antes de que tenga que renovarse. La propiedad MinSubscriptionExpiration representa la cantidad mínima de tiempo que se puede conceder a los clientes. Por ejemplo, si la cantidad mínima de tiempo está definida en 1.200 segundos y un cliente solicita un intervalo de tiempo de espera de 200 segundos, se concederá al cliente el período mínimo de expiración permitido: 1.200 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 1.200 segundos (20 minutos). |
SubscribeToCollapsedDG |
Opcional |
Booleano |
Si se establece en True (el valor predeterminado), las aplicaciones cliente podrán suscribirse a los grupos de distribución que actualmente no estén expandidos en la lista de contactos. Así, el cliente puede mantener actualizada al minuto información de presencia sobre cada miembro del grupo. Si se define en False, las aplicaciones cliente no podrán suscribirse a los grupos “contraídos”. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
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
Ninguno. New-CsUserServicesConfiguration no acepta la entrada transferida.
Tipos de valores devueltos
New-CsUserServicesConfiguration crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"
El comando que se muestra en el Ejemplo 1 crea una colección de opciones de configuración de Servicios del usuario para el sitio de Redmond (-Identity site:Redmond). Además de especificar la identidad, el comando establece el número máximo de contactos (-MaxContacts 500) y la hora del día en que se lleva a cabo el mantenimiento (-MaintenanceTimeOfDay "11:00 PM"). Tenga en cuenta que este comando producirá un error si la configuración de Servicios del usuario ya se ha definido para el sitio de Redmond. Esto ocurre porque está limitado a una colección de opciones de configuración por sitio.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x
En el Ejemplo 2 también se crea una colección nueva de opciones de configuración de Servicios del usuario para el sitio Redmond. Sin embargo, en este ejemplo, la colección se crea inicialmente en la memoria y es después cuando se aplica al sitio Redmond. Para ello, el primer comando de este ejemplo usa New-CsUserServicesConfiguration y el parámetro InMemory para crear una colección (con la identidad site:Redmond) que solo existe en la memoria. Como esta colección solamente existe en la memoria, el objeto User Services se debe almacenar en una variable. En este caso, la variable se llama $x.
Una vez creada la colección virtual, se usan los comandos 2 y 3 para modificar los valores de las propiedades MaxContacts y MaintenanceTimeOfDay. A continuación, el comando final del ejemplo usa Set-CsUserServicesConfiguration para convertir la configuración virtual en una colección real de opciones de Servicios de usuarios aplicadas al sitio de Redmond. El paso final es de crucial importancia: si no llama a Set-CsUserServicesConfiguration, no se aplicará ninguna configuración al sitio de Redmond y la configuración virtual desaparecerá en cuanto termine la sesión de Windows PowerShell o elimine la variable $x.
Vea también
Otros recursos
Get-CsUserServicesConfiguration
Remove-CsUserServicesConfiguration
Set-CsUserServicesConfiguration