Compartir a través de

Consultas en la base de datos de seguimiento SQL mediante Windows PowerShell

  • Artículo

En este ejemplo se muestra cómo se deben usar los scripts de SQL para crear un cmdlet típico de Windows PowerShell que recupere datos de seguimiento. También permite comprender las vistas SQL que proporciona Windows Server AppFabric. Este ejemplo funciona con cualquier aplicación. Es recomendable usar la Aplicación común Windows Server AppFabric de ejemplo, creada para su uso con ejemplos de AppFabric. Para buscarla, vaya a la carpeta <ejemplos>\SampleApplication\OrderApplication, donde <ejemplos> representa la ruta de acceso en la que instaló los ejemplos de AppFabric.

Nota

Los ejemplos se proporcionan únicamente con fines de aprendizaje. No están concebidos para su uso en un entorno de producción ni se han probado en este tipo de entorno. Microsoft no proporciona asistencia técnica para estos ejemplos.

Requisitos previos

Los usuarios deben tener algunos conocimientos sobre los comandos SQL y los scripts de Windows PowerShell. Para el ejemplo se supone lo siguiente:

  • Windows PowerShell 2.0 está instalado

  • SQL Server 2008 Express está instalado

  • AppFabric está instalado

Ubicación y archivos de ejemplo

  • Scripts\ScriptCmdlets.ps1

  • Readme.mhtml

Configuración y ejecución de este ejemplo

Para ejecutar este script:

  1. Abra la consola de Windows PowerShell con privilegios administrativos.

  2. Navegue a la carpeta que contiene el ejemplo.

  3. Navegue al subdirectorio Scripts de la carpeta de ejemplos SQLMonitoringQueryCmdlets.

  4. Ejecute los comandos siguientes:

    Set-ExecutionPolicy Unrestricted
Import-Module ‘.\ScriptCmdlets.ps1’

Descripción de este ejemplo

El ejemplo de consulta de seguimiento expone los cmdlets siguientes:

  • Get-ASAppTrackedPropertyName

  • Get-ASAppTrackedInstance

  • Get-ASAppTrackedWcfEvent

  • Get-ASAppTrackedWfEvent

Get-ASAppTrackedPropertyName

Este cmdlet consulta en la base de datos de seguimiento los nombres de propiedad supervisados que están disponibles para un servicio específico. Para un servicio de flujo de trabajo dado, el marco de seguimiento captura las propiedades de determinados eventos, como las variables de entorno y las variables de usuario supervisadas. Este cmdlet devuelve los nombres de todas las variables que están disponibles para un servicio de flujo de trabajo determinado.

Sintaxis

Get-ASAppTrackedPropertyName [-Database<String>] [-MachineName<String>] [-Server <String>] [-SiteName <String>] [-VirtualPath <String>]

Parámetros

Database: parámetro obligatorio. Cadena que indica la base de datos que se va a consultar.

MachineName: parámetro opcional. Cadena que se usa para consultar únicamente datos de seguimiento generados en el equipo especificado.

Server: parámetro obligatorio. Cadena que indica el servidor SQL Server que se va a consultar.

SiteName: parámetro opcional. Cadena que se usa para consultar los nombres de propiedad de las instancias en el sitio especificado.

VirtualPath: parámetro opcional. Cadena que se usa para consultar los nombres de propiedad de las instancias de servicios que se encuentran en la ruta de acceso virtual especificada o debajo de ella.

Canalizaciones

El cmdlet Get-ASAppTrackedPropertyName se puede canalizar desde el cmdlet Get-ASAppService. Get-ASAppService devuelve un ApplicationObject que se puede usar como entrada para Get-ASAppTrackedPropertyName.

Ejemplos

Get-ASAppTrackedPropertyName –SiteName “Default Web Site” –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppService –SiteName “Default Web Site” | Get-ASAppTrackedPropertyName –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedInstance**

Use este cmdlet para permitir que los usuarios consulten datos acerca de las instancias de servicio supervisadas. Los usuarios pueden especificar los criterios que deben cumplir las instancias supervisadas para que se devuelvan. Este cmdlet funciona en cualquier ámbito operativo: equipo, sitio, aplicación, servicio y ruta de acceso virtual.

Sintaxis

Get-ASAppTrackedInstance [-Count <Switch>] [-Database<String>] [-MachineName<String>] [-MaxResults <int>] [-ModifiedSince <DateTime>] [-Server <String>]  [-SiteName <String>] [-VirtualPath <String>]

Parámetros

Count: parámetro opcional. Marca que, al especificarse, indica al cmdlet que devuelva el recuento de instancias que cumplen los criterios especificados.

Database: parámetro obligatorio. Cadena que indica la base de datos que se va a consultar.

MachineName: parámetro opcional. Cadena que se usa para consultar únicamente datos de seguimiento generados en el equipo especificado.

MaxResults: parámetro opcional. Número entero que se usa para especificar el número máximo de resultados presentados. El valor predeterminado es 50.

ModifiedSince: parámetro opcional. Valor de fecha y hora que se usa para consultar solamente instancias modificadas con posterioridad a este valor.

Server: parámetro obligatorio. Cadena que indica el servidor SQL Server que se va a consultar.

SiteName: parámetro opcional. Cadena que se usa para consultar solamente instancias en el sitio especificado.

VirtualPath: parámetro opcional. Cadena que se usa para consultar solamente instancias que se encuentran en la ruta de acceso virtual especificada o debajo de ella.

Canalizaciones

El cmdlet Get-ASAppTrackedInstance se puede canalizar desde el cmdlet Get-ASAppService. Get-ASAppService devuelve un ApplicationObject que se puede usar como entrada para Get-ASAppTrackedInstance.

Ejemplos

Get-ASAppTrackedInstance –SiteName “Default Web Site” –Count –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedInstance –MaxResults 10  –ModifiedSince 2-20-2010 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppService –SiteName “Default Web Site” | Get-ASAppTrackedInstance –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWcfEvent**

Este cmdlet consulta datos de eventos de WCF en la base de datos de seguimiento. Este cmdlet funciona en cualquier ámbito operativo: equipo, sitio, aplicación, servicio y ruta de acceso virtual.

Sintaxis

Get-ASAppTrackedWcfEvent [-Count <Switch>] [-Database<String>] [-EmitTimeFrom <DateTime>] [-EmitTimeTo <DateTime>] [-MachineName<String>] [-MaxResults <int>]  [-Server <String>]  [-SiteName <String>] [-VirtualPath <String>]

Parámetros

Count: parámetro opcional. Marca que, al especificarse, indica al cmdlet que devuelva el recuento de eventos de WCF que cumplen los criterios especificados.

Database: parámetro obligatorio. Cadena que indica la base de datos que se va a consultar.

EmitTimeFrom: parámetro opcional. Valor de fecha y hora que se usa para consultar solamente eventos de WCF que se emitieron con posterioridad a este valor.

EmitTimeFrom: parámetro opcional. Valor de fecha y hora que se usa para consultar solamente eventos de WCF que se emitieron con anterioridad a este valor.

MachineName: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WCF generados en el equipo especificado.

MaxResults: parámetro opcional. Número entero que se usa para especificar el número máximo de resultados presentados. El valor predeterminado es 50.

Server: parámetro obligatorio. Cadena que indica el servidor SQL Server que se va a consultar.

SiteName: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WCF generados en el sitio especificado.

VirtualPath: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WCF generados en la ruta de acceso virtual especificada o debajo de ella.

Canalizaciones

El cmdlet Get-ASAppTrackedWcfEvent se puede canalizar desde el cmdlet Get-ASAppService. Get-ASAppService devuelve un ApplicationObject que se puede usar como entrada para Get-ASAppTrackedWcfEvent.

Ejemplos

Get-ASAppTrackedWcfEvent –SiteName “Default Web Site” –Count  –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWcfEvent  –MaxResults 10 –EmitTimeFrom 2-20-2010 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWcfEvent –EmitTimeFrom 2-18-2010 –EmitTimeTo 2-20-2010 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppService –SiteName “Default Web Site” | Get-ASAppTrackedWcfEvent –MaxResult 5 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWfEvent**

Este cmdlet consulta datos de eventos de WF en la base de datos de seguimiento. Este cmdlet funciona en cualquier ámbito operativo: equipo, sitio, aplicación, servicio y ruta de acceso virtual.

Sintaxis

Get-ASAppTrackedWfEvent [-Count <Switch>] [-Database<String>] [-EmitTimeFrom <DateTime>] [-EmitTimeTo <DateTime>] [-MachineName<String>] [-MaxResults <int>] [-Server <String>] [-SiteName <String>] [-VirtualPath <String>]

Parámetros

Count: parámetro opcional. Marca que, al especificarse, indica al cmdlet que devuelva el recuento de eventos de WF que coinciden con los criterios especificados.

Database: parámetro obligatorio. Cadena que indica la base de datos que se va a consultar.

EmitTimeFrom: parámetro opcional. Valor de fecha y hora que se usa para consultar solamente eventos de WF que se emitieron con posterioridad a este valor.

EmitTimeFrom: parámetro opcional. Valor de fecha y hora que se usa para consultar solamente eventos de WF que se emitieron con anterioridad a este valor.

MachineName: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WF emitidos en el equipo especificado.

MaxResults: parámetro opcional. Número entero que se usa para especificar el número máximo de resultados presentados. El valor predeterminado es 50.

Server: parámetro obligatorio. Cadena que indica el servidor SQL Server que se va a consultar.

SiteName: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WF generados en el sitio especificado.

VirtualPath: parámetro opcional. Cadena que se usa para consultar únicamente eventos de WF generados en la ruta de acceso virtual especificada o debajo de ella.

Canalizaciones

El cmdlet Get-ASAppTrackedWfEvent se puede canalizar desde el cmdlet Get-ASAppService. Get-ASAppService devuelve un ApplicationObject que se puede usar como entrada para Get-ASAppTrackedWfEvent.

Ejemplo

Get-ASAppTrackedWfEvent –SiteName “Default Web Site” –Count –EmitTimeFrom 2-20-2010 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWfEvent –VirtualPath “/calculator/service.xamlx” –MaxResults 10 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWfEvent –EmitTimeFrom 2-18-2010 –EmitTimeTo 2-20-2010 –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppTrackedWfEvent –Count –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Get-ASAppService –SiteName “Default Web Site” | Get-ASAppTrackedWfEvent –Count –Server localhost\SQLExpress –Database ApplicationServerMonitoringDatabase

Eliminación de este ejemplo

Para quitar este ejemplo, elimine sus archivos y revierta la política de ejecución al nivel anterior o al valor predeterminado para Windows PowerShell con el siguiente comando:

Set-ExecutionPolicy Default

  2011-12-05