Compartir a través de


Visualización de servicios mediante cmdlets de AppFabric

En este tema se describe el procedimiento para visualizar servicios e instancias de servicio mediante cmdlets de AppFabric.

Nota

Para ejecutar un cmdlet de AppFabric de manera manual, abra la consola de Windows PowerShell para AppFabric, escriba el cmdlet y presione ENTRAR. Para obtener más información acerca de la ejecución de cmdlets, consulte Ejecución de cmdlets de AppFabric. Para obtener información sobre cualquiera de las clases o parámetros comunes que se usan en las instrucciones de sintaxis de este documento, consulte Referencia de Windows PowerShell para AppFabric.

Procedimiento para obtener los servicios de una aplicación

El cmdlet Get-ASAppService muestra todos los servicios disponibles en un ámbito específico. En la siguiente tabla se describen los parámetros del cmdlet.

Parámetro Descripción

-Root (opcional)

Si se especifica, no deben especificarse los parámetros –Uri, -SiteName ni –ServiceObject. Si se usa este parámetro, el cmdlet devuelve todos los servicios hospedados en el servidor local del entorno IIS/WAS.

Get-ASAppService –Root

-SiteName (opcional)

Si se especifica, no deben especificarse los parámetros –Root, -Uri ni –ServiceObject. Si se usa este parámetro, el cmdlet devuelve todos los servicios hospedados en el sitio web especificado.

Get-ASAppService –SiteName “Default Web Site”

-VirtualPath (opcional)

Parámetro opcional que se usa con -SiteName cuando no se ha especificado ni –Uri ni –ServiceObject. Especifica la ruta de acceso virtual a un servicio o aplicación; por ejemplo, /MyDir1/MyApp1/POService.svc.

Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (opcional)

Si se especifica, no deben especificarse –SiteName, -VirtualPath ni –ServiceObject. Especifica un URI de un sitio, aplicación o servicio. Si se especifica, sólo se devuelven los servicios disponibles bajo ese URI.

Get-ASAppService –Uri “https://localhost/MyWFServiceApplication”

-ApplicationObject (opcional)

Si se especifica, no deben especificarse –SiteName, -VirtualPath ni –Uri. Este parámetro se usa normalmente para canalizar la salida del cmdlet Get-ASAppService.

Get-Application | Get-ASAppService

-Count (opcional)

Devuelve el recuento de servicios.

Get-ASAppService -Count

Para obtener más información acerca de este cmdlet, vea Get-ASAppService.

Procedimiento para obtener una instancia de servicio

El cmdlet Get-ASAppServiceInstance muestra información sobre los objetos de la instancia de servicio de uno o más almacenes de persistencia. El cmdlet Get-ASAppServiceInstance consulta un conjunto específico de almacenes de persistencia y devuelve una recopilación de las instancias de servicio que coinciden con los parámetros de consulta proporcionados. En la siguiente tabla se describen los parámetros del cmdlet.

Parámetro Descripción

-Root (opcional)

Si se especifica, no deben especificarse los parámetros –Uri, -SiteName ni –ServiceObject. Si se usa este parámetro, el cmdlet devuelve todas las instancias de servicio del servidor local.

Get-ASAppServiceInstance –Root

-SiteName (opcional)

Si se especifica, no deben especificarse -Uri ni –ServiceObject. Especifica el nombre de un sitio. Si se especifica, sólo se devolverán las instancias de servicios hospedados en el sitio especificado.

Get-ASAppServiceInstance –SiteName “Default Web Site”

-VirtualPath (opcional)

Parámetro opcional que se usa con -SiteName cuando no se ha especificado ni –Uri ni –ServiceObject. Especifica la ruta de acceso virtual a un servicio o aplicación; por ejemplo, /MyDir1/MyApp1/POService.svc.

Get-ASAppServiceInstance –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (opcional)

Si se especifica, no deben especificarse –SiteName, -VirtualPath ni –ServiceObject. Especifica un URI de un sitio, aplicación o servicio. Si se especifica, sólo se devuelven las instancias de servicio que se encuentran bajo ese URI.

Get-ASAppServiceInstance –Uri “https://localhost/MyWFServiceApplication”

-ServiceInfo (opcional)

Si se especifica, no deben especificarse –SiteName, -VirtualPath ni –Uri. Especifica un objeto ServiceInfo que se usa para determinar las instancias de servicio sobre las que debe devolverse información. Este parámetro se usa normalmente para canalizar la salida del cmdlet Get-ASAppService.

Get-ASAppService | Get-ASAppServiceInstance 

-ApplicationInfo (opcional)

Si se especifica, no deben especificarse –SiteName, -VirtualPath ni –Uri. Especifica un objeto ApplicationInfo que se usa para determinar las instancias de servicio sobre las que debe devolverse información. Este parámetro se usa normalmente para canalizar la salida del cmdlet Get-ASApplication.

Get-ASApplication | Get-ASAppServiceInstance

-Count (opcional)

Especifica que sólo debe devolverse un número determinado de instancias encontradas que coinciden con los parámetros de consulta.

//root level is the default level
Get-ASAppServiceInstance -Count

-CreatedTimeFrom (opcional)

Especifica el inicio de un intervalo de tiempo en el que una instancia de servicio se inició por primera vez. Si se especifica este parámetro, sólo se devolverán las instancias iniciadas en ese momento o posteriormente.

Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009

-CreatedTimeTo (opcional)

Especifica el fin de un intervalo de tiempo en el que una instancia de servicio se inició por primera vez. Si se especifica este parámetro, sólo se devolverán las instancias iniciadas en ese momento o anteriormente.

Get-ASAppServiceInstance -CreatedTimeTo 6/1/2009
Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009 -CreatedTimeTo 6/1/2009

-MachineName (opcional)

Especifica un nombre de equipo. Si se especifica, sólo se devolverán las instancias de servicio bloqueadas por ese equipo.

Get-ASAppServiceInstance -MachineName

-ModifiedTimeFrom (opcional)

Especifica el inicio de un intervalo de tiempo en el que una instancia de servicio se modificó. Si se especifica este parámetro, sólo se devolverán las instancias modificadas en ese momento o posteriormente.

Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009

-ModifiedTimeTo (opcional)

Especifica el fin de un intervalo de tiempo en el que una instancia de servicio se modificó. Si se especifica este parámetro, sólo se devolverán las instancias modificadas en ese momento o anteriormente.

Get-ASAppServiceInstance -ModifiedTimeTo 6/1/2009
Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009 -ModifiedTimeTo 6/1/2009

-ExceptionName (opcional)

Especifica una cadena que representa el nombre de tipo completo de una excepción de .NET Framework. Si se especifica, sólo se devolverán las instancias de servicio finalizadas a causa de la excepción especificada.

-MaxRows (opcional)

Especifica el número de filas (instancias de servicio) que se devolverán.

Get-ASAppServiceInstance –MaxRows 100

-InstanceId (opcional)

Especifica el identificador de instancia (especificado como GUID) de la instancia de servicio que se devolverá. El identificador de instancia identifica de forma exclusiva una instancia de servicio. Si se especifica este parámetro, se devuelve la instancia con ese identificador (si existe).

-ServiceType (opcional)

Especifica un servicio por su tipo. Si se especifica, sólo se devolverán las instancias de ese tipo de servicio. El tipo de servicio puede expresarse como ruta de acceso completa o parcial, o bien como nombre y espacio de nombres de .NET Framework completo o parcial. Si se establece un tipo de servicio por espacio de nombres, debe usarse el carácter "#" para separar el tipo de servicio del espacio de nombres. Por ejemplo, si el nombre completo del servicio CLR de .NET Framework es Contoso.Web.Sales.POService, el valor de parámetro debe ser "Contoso.Web.Sales#POService".

No se pueden indicar explícitamente caracteres comodín; sin embargo, este parámetro contiene caracteres comodín ("*") implícitos antes y después del valor proporcionado. Por ejemplo, "Contoso/Service.svc" se trata como "*Contoso/Service.svc*" y "Sales#POService" se trata como "*Sales#POService*".

-Status (opcional)

Especifica el estado de la instancia. Si se especifica, la consulta sólo devolverá las instancias de servicio con el estado especificado. Los valores posibles para Status son: En ejecución, Suspendido y Completado.

Get-ASAppServiceInstance -Status Completed

-Condition (opcional)

Especifica la condición de la instancia. Si se especifica, la consulta sólo devolverá las instancias de servicio con la condición especificada. Los valores posibles para Condition son: Activo, Inactivo, Excepción, Suspensión del usuario, Correcto, Cancelado y Finalizado.

Get-ASAppServiceInstance -Condition Cancelled

-GroupBy (opcional)

Especifica un campo que se usa para agrupar los recuentos de instancias de servicio devueltas. Los valores posibles para GroupBy son: UniqueApplication, UniqueService, ServiceType, Exception, Status, Site y MachineName.

Get-ASAppServiceInstance –GroupBy Status

-OrderBy (opcional)

Muestra las instancias de servicio clasificadas en orden descendente de la última vez que se ha actualizado.

-ExcludeSubFolders (opcional)

Si se especifica, excluye de los resultados de la aplicación principal los resultados para instancias de subaplicaciones.

-Timeout (opcional)

Especifica durante cuánto tiempo el cmdlet espera la respuesta de la base de datos. El valor es un valor de tiempo con el formato hh:mm:ss. El valor mínimo es 00:00:01 (1 segundo), el valor máximo es TimeSpan.MaxValue. Si se deja en blanco, el valor predeterminado es 00:02:00 (2 minutos).

-ReturnBinaryProperties (opcional)

Si se especifica, devuelve la matriz de propiedades de metadatos binarios del objeto InstanceInfo devuelto.

Para obtener más información acerca de este cmdlet, vea Get-ASAppServiceInstance.

  2012-03-05