Compartir a través de

  • Artículo

Set-CsServerApplication

 

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

Modifica los valores de propiedad de una aplicación de servidor existente. Las aplicaciones de servidor son aplicaciones hospedadas por Microsoft Lync Server 2010.

Sintaxis

Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Las aplicaciones de servidor son programas individuales que se ejecutan en Lync Server 2010. El cmdlet Set-CsServerApplication proporciona a los administradores una forma de modificar los valores de propiedad de cualquier aplicación que se esté ejecutando como parte del Lync Server.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsServerApplication 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 desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para la aplicación de servidor que se va a modificar. Las Identidades de las aplicaciones de servidor están formadas por el servicio donde se hospeda la aplicación y el nombre de la aplicación. Por ejemplo, la aplicación de servidor llamada QoEAgent podría tener una Identidad similar a esta: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Instance

Opcional

Objeto ServerApplication.Application

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

Critical

Opcional

Booleano

Si se establece en True (el valor predeterminado), Lync Server no se iniciará, a menos que la aplicación en cuestión se pueda iniciar. Si es False, Lync Server se iniciará independientemente de que la aplicación se pueda iniciar.

Enabled

Opcional

Booleano

Establece el valor en True para habilitar la aplicación. Establece el valor en False para deshabilitar la aplicación.

Priority

Opcional

Entero

Indica el orden de ejecución para las aplicaciones de servidor. La aplicación con prioridad 0 se inicia primero. A continuación se iniciará la aplicación con prioridad 1, y así sucesivamente. Tenga en cuenta que cada servicio que hospeda una aplicación de servidor tiene su propio conjunto único de prioridades. Por ejemplo, el servicio registrador puede hospedar tres aplicaciones con sus correspondientes prioridades 0, 1 y 2. De igual manera, el servicio Servidor perimetral puede tener cuatro aplicaciones. Estas aplicaciones tendrán las prioridades 0, 1, 2 y 3.

Si no se especifica una prioridad, la aplicación se agregará automáticamente al final de la lista de prioridades. Si se agrega o quita una aplicación, las prioridades de las otras aplicaciones se ajustarán consecuentemente. Por ejemplo, si elimina una aplicación cuya prioridad es 0, la aplicación que tenía previamente la prioridad 1 establecerá su prioridad automáticamente en 0.

ScriptName

Opcional

Cadena de caracteres

Ruta del script Microsoft SIP Processing Language (MSPL) que utiliza la aplicación. MSPL es un lenguaje de scripting que se usa para filtrar y enrutar mensajes SIP.

Uri

Opcional

Cadena de caracteres

El Identificador Único de Recursos Uniforme (URI) de la aplicación. Por ejemplo, la aplicación QoEAgent tiene el URI https://www.microsoft.com/LCS/QoEAgent.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

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

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Set-CsServerApplication acepta las instancias transferidas del objeto de aplicación de servidor.

Tipos de valores devueltos

Set-CsServerApplication no devuelve un valor ni un objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application.

Ejemplo

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

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

El comando del Ejemplo 1 habilita la aplicación de servidor cuyo parámetro Identity es Registrar:atl-cs-001.litwareinc.com/ExumRouting. Como las identidades han de ser únicas, este comando habilitará únicamente una aplicación de servidor.

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

Get-CsServerApplication | Where-Object {$_.Enabled -eq $False} | Set-CsServerApplication -Enabled $True

El comando anterior habilita todas las aplicaciones de servidor que están deshabilitadas. Para ello, primero llama a Get-CsServerApplication para devolver una colección de todas las aplicaciones de servidor que se usan en la organización. Esta colección se transfiere a continuación a Where-Object, que selecciona únicamente aquellas aplicaciones en las que la propiedad Enabled es igual a False. A su vez, esta colección filtrada se transfiere a Set-CsServerApplication, que toma cada elemento de la colección y establece la propiedad Enabled en True.