Compartir a través de

  • Artículo

Get-CsServerApplication

 

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

Devuelve información acerca de las aplicaciones de servidor en uso en la organización. Las aplicaciones de servidor son aplicaciones hospedadas por Microsoft Lync Server 2010.

Sintaxis

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

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

Descripción detallada

Las aplicaciones de servidor son los programas individuales que se ejecutan en Lync Server 2010. El cmdlet Get-CsServerApplication provee a los administradores de un modo de devolver información acerca de cualquier aplicación (o de todas ellas) que se ejecuta como parte de Lync Server.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsServerApplication localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para la aplicación del servidor que se va a recuperar. 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: service: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Simplemente deje en blanco el nombre de la aplicación para recuperar una colección de todas las aplicaciones que se están ejecutando en un determinado servicio:

-Identity "Registrar:atl-cs-001.litwareinc.com "

Si omite este parámetro, al llamar a Get-CsServerApplication, se devolverán todas las aplicaciones del servidor.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al devolver una aplicación del servidor o conjunto de aplicaciones del servidor. Por ejemplo, para devolver todas las aplicaciones del servidor que tengan el valor de cadena "IIMFilter" en cualquier parte de Identity, use esta sintaxis: -Filter "*IIMFilter*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de aplicación del servidor a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsServerApplication no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsServerApplication devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Ejemplo

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

Get-CsServerApplication

El comando que aparece en el Ejemplo 1 devuelve información acerca de las aplicaciones de servidor que se están utilizando en la organización. Esto se consigue llamando a Get-CsServerApplication sin ningún parámetro.

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

Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"

En el Ejemplo 2, se devuelve información de todas las aplicaciones del servidor que se están ejecutando en el servicio EdgeServer:atl-edge-001.litwareinc.com.

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

Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"

En el Ejemplo 3, se devuelve información para una única aplicación del servidor: la aplicación con la Identity Registrar:atl-cs-001.litwareinc.com/ExumRouting".

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

Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"

El comando anterior devuelve todas las aplicaciones del servidor configuradas para su uso en el grupo de servidores atl-cs-001.litwareinc.com. Para ello se usa el parámetro Filter junto con el valor de filtro "service:*:atl-cs-001.litwareinc.com*". El valor de filtro limita los datos devueltos a aplicaciones que tienen una Identity que comienza con los caracteres "service:" e incluye los caracteres ":atl-cs-001.litwareinc.com".

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

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

En el Ejemplo 5, se devuelve información para todas las aplicaciones del servidor que se encuentran deshabilitadas. Para ello, el comando llama en primer lugar a Get-CsServerApplication para devolver una colección de todas las aplicaciones del servidor configuradas para usarlas en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente aquellas aplicaciones en las que la propiedad Enabled es igual a False.

-------------------------- Ejemplo 6 ------------------------

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

El Ejemplo 6 es una variante del comando del Ejemplo 5. En el Ejemplo 6 se devuelve información para todas las aplicaciones de servidor marcadas como esenciales y que se encuentran deshabilitadas. Para ello, el comando llama en primer lugar a Get-CsServerApplication sin ningún parámetro; esto devuelve una colección de todas las aplicaciones de servidor configuradas para usarse. A continuación, esta colección se transfiere a Where-Object, que selecciona solamente aquellas aplicaciones que cumplen dos criterios: la propiedad Critical debe ser igual a True y la propiedad Enabled, a False. El operador -and garantiza que sólo se devolverán aquellos objetos que cumplan ambos criterios.

-------------------------- Ejemplo 7 ------------------------

Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}

En el Ejemplo 7, se devuelve información para cualquier aplicación de servidor que tenga el valor de cadena "routing" en cualquier parte de su URI. Esta tarea se lleva a cabo usando en primer lugar Get-CsServerApplication para recuperar todas las aplicaciones de servidor que se estén usando en ese momento. A continuación, la colección resultante se transfiere a Where-Object, que solo selecciona las aplicaciones en las que la propiedad Uri incluya el valor de cadena "routing".

-------------------------- Ejemplo 8 ------------------------

Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}

El comando anterior devuelve información acerca de todas las aplicaciones de servidor asignadas a un script. Para ello, el comando recupera en primer lugar una colección de todas las aplicaciones de servidor que se estén usando en ese momento, información que se recupera llamando a Get-CsServerApplication sin ningún parámetro. A continuación, la colección completa de aplicaciones de servidor se transfiere al cmdlet Where-Object, que selecciona solo aquellas en las que la propiedad ScriptName no sea igual a un valor nulo. Si la propiedad ScriptName no es igual a un valor nulo, esto significa que dicha aplicación tiene asignado un script.