Set-CsUserServer
Última modificación del tema: 2012-04-23
Permite modificar un grupo de servidores Servicios del usuario existente. Entre otras cosas, el grupo de servidores Servicios del usuario proporciona información de presencia y ayuda a administrar las conferencias.
Sintaxis
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Servicios del usuario es un componente que abarca muchos usos y que desempeña una amplia variedad de funciones clave de Microsoft Lync Server 2010; por ejemplo, Servicios del usuario proporciona información de presencia, ayuda a administrar conferencias (a través de los componentes Foco y Fábrica de foco), administra la autorización de usuarios y el enrutamiento en el nivel de usuario, y actúa como interfaz principal para la base de datos back-end. Servicios del usuario también resulta útil para el aprovisionamiento de cuentas de usuario.
Por este motivo, resulta importante para los administradores saber exactamente cómo se han configurado los grupos de servidores Servicios del usuario y, si es preciso, modificar las configuraciones. Puede recuperar información sobre sus grupos de servidores Servicios del usuario con este comando:
Get-CsService -UserServer
Asimismo, puede usar el cmdlet Set-CsUserServer para realizar cambios en cualquiera de estos grupos de servidores. Set-CsUserServer permite a los administradores cambiar la base de datos de usuario y el servidor de conferencias asociado con un grupo de servidores. El cmdlet también permite modificar el puerto usado para conexiones con la Fábrica de foco.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsUserServer de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserServer"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único del grupo de servidores Servicios del usuario que se va a modificar. Por ejemplo: -Identity "UserServer:atl-cs-001.litwareinc.com". Puede omitir el prefijo "UserServer:" al especificar un servidor de usuario. Por ejemplo: -Identity "atl-cs-001.litwareinc.com". |
ConferenceServer |
Opcional |
Cadena de caracteres |
Identificador de servicio del servidor de conferencias asociado con el grupo de servidores Servicios del usuario. Por ejemplo: -ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com". |
McuFactorySipPort |
Opcional |
Entero |
Puerto usado para conectarse a la Fábrica de foco (McuFactory). La Fábrica de foco asigna unidades de control de medios (MCU) para poder añadir tipos de medio específicos, como por ejemplo, audio para las conferencias. |
UserDatabase |
Opcional |
Cadena de caracteres |
Identificador de servicio de la base de datos de usuarios asociada con el grupo de servidores Servicios del usuario. Por ejemplo: -UserDatabase "UserDatabase:atl-cs-001.litwareinc.com". |
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. |
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. Set-CsUserServer no acepta entradas transferidas.
Tipos de valores devueltos
Set-CsUserServer no devuelve ningún objeto ni valor. En su lugar, el cmdlet modifica las instancias existentes del objeto Microsoft.Rtc.Management.Xds.DisplayUserServer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
El comando que se muestra en el Ejemplo 1 cambia McuFactorySipPort por un solo grupo de servidores Servicios del usuario: el grupo de servidores con la identidad UserServer:atl-cs-001.litwareinc.com. En este ejemplo, el puerto se cambia a 445.
-------------------------- Ejemplo 2 ------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
El comando mostrado en el Ejemplo 2 es una variación del comando mostrado en el Ejemplo 1. En este caso, se modifica el valor de McuFactorySipPort para todos los grupos de servidores Servicios del usuario de la organización. Para ello, el comando comienza usando Get-CsService y el parámetro UserServer para devolver una recopilación de todos los grupos de servidores Servicios del usuario que estén en uso. A continuación, esta recopilación se transfiere al cmdlet ForEach-Object, que define la propiedad McuFactorySipPort de todos los grupos de servidores de la recopilación en 445. Los datos deben transferirse al cmdlet ForEach-Object, porque el cmdlet Set-CsUserServer no puede aceptar datos transferidos.