Partager via

Interrogation de la base de données de surveillance SQL à l'aide de Windows PowerShell

  • Article

Cet exemple décrit l'utilisation des scripts SQL pour créer une cmdlet Windows PowerShell classique qui récupère les données de surveillance. Il vous aide également à comprendre les vues SQL disponibles dans Windows Server AppFabric. Cet exemple est adapté à toutes les applications. Nous recommandons l'Exemple d'application courante de Windows Server AppFabric créé pour être utilisé avec les exemples AppFabric. Pour trouver cette application, accédez au dossier <samples>\SampleApplication\OrderApplication, où <samples> représente le chemin d'accès aux exemples AppFabric.

Notes

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucune assistance technique pour ces exemples.

Conditions préalables

Les utilisateurs doivent disposer de certaines connaissances relatives aux scripts Windows PowerShell et aux commandes SQL. Cet exemple repose sur les hypothèses suivantes :

  • Windows PowerShell 2.0 est installé

  • SQL Server 2008 Express est installé

  • AppFabric est installé

Emplacement et fichiers de l'exemple

  • Scripts\ScriptCmdlets.ps1

  • Readme.mhtml

Configuration et exécution de l'exemple

Pour exécuter le script :

  1. Ouvrez la console Windows PowerShell avec des privilèges d'administrateur.

  2. Accédez au dossier contenant l'exemple.

  3. Accédez au sous-répertoire Scripts du dossier d'exemples SQLMonitoringQueryCmdlets.

  4. Exécutez les commandes suivantes :

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

Description de l'exemple

L'exemple de requête de surveillance expose les cmdlets suivantes :

  • Get-ASAppTrackedPropertyName

  • Get-ASAppTrackedInstance

  • Get-ASAppTrackedWcfEvent

  • Get-ASAppTrackedWfEvent

Get-ASAppTrackedPropertyName

Cette cmdlet interroge la base de données de surveillance au sujet des noms de propriétés suivies qui sont disponibles pour un service particulier. Pour un service de flux de travail donné, l'infrastructure de suivi capture les propriétés de certains événements, telles que les variables d'environnement et d'utilisateur suivi. Cette cmdlet renvoie les noms de toutes les variables qui sont disponibles pour un service de flux de travail donné.

Syntaxe

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

Paramètres

Database - Paramètre obligatoire. Chaîne spécifiant la base de données à interroger.

MachineName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les données de surveillance générées sur l'ordinateur spécifié.

Server - Paramètre obligatoire. Chaîne spécifiant le serveur SQL à interroger.

SiteName - Paramètre facultatif. Chaîne utilisée pour interroger les noms de propriété d'instances pour le site spécifié.

VirtualPath - Paramètre facultatif. Chaîne utilisée pour interroger les noms de propriété d'instances de services figurant dans ou sous le chemin d'accès virtuel spécifié.

Chaînage

La cmdlet Get-ASAppTrackedPropertyName peut être chaînée à partir de la cmdlet Get-ASAppService. Get-ASAppService renvoie un ApplicationObject qui peut être utilisé comme entrée pour Get-ASAppTrackedPropertyName.

Exemples

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**

Cette cmdlet permet d'émettre une requête relative à données d'instances de service ayant été suivies. Vous pouvez spécifier des critères qui doivent être remplis en relation avec les instances suivies pour que celles-ci soient renvoyées. Elle fonctionne sur toutes les étendues opérationnelles : ordinateur, site, application, service et chemin d'accès virtuel.

Syntaxe

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

Paramètres

Count - Paramètre facultatif. Indicateur ayant pour effet que la cmdlet renvoie un nombre d'instances correspondant aux critères spécifiés.

Database - Paramètre obligatoire. Chaîne spécifiant la base de données à interroger.

MachineName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les données de surveillance générées sur l'ordinateur spécifié.

MaxResults - Paramètre facultatif. Nombre entier permettant de spécifier le nombre maximal de résultats affichés. La valeur par défaut est 50.

ModifiedSince - Paramètre facultatif. Date et heure utilisées pour interroger uniquement les instances modifiées postérieurement aux valeurs définies.

Server - Paramètre obligatoire. Chaîne spécifiant le serveur SQL à interroger.

SiteName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les instances pour le site spécifié.

VirtualPath - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les instances figurant dans ou sous le chemin d'accès virtuel spécifié.

Chaînage

La cmdlet Get-ASAppTrackedInstance peut être chaînée à partir de la cmdlet Get-ASAppService. Get-ASAppService renvoie un ApplicationObject qui peut être utilisé comme entrée pour Get-ASAppTrackedInstance.

Exemples

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**

Cette cmdlet interroge la base de données de surveillance sur les données d'événement WCF. Elle fonctionne sur toutes les étendues opérationnelles : ordinateur, site, application, service et chemin d'accès virtuel.

Syntaxe

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

Paramètres

Count - Paramètre facultatif. Indicateur ayant pour effet que la cmdlet renvoie un nombre d'événements WCF correspondant aux critères spécifiés.

Database - Paramètre obligatoire. Chaîne spécifiant la base de données à interroger.

EmitTimeFrom - Paramètre facultatif. Date et heure utilisées pour interroger uniquement les événements WCF émis postérieurement aux valeurs définies.

EmitTimeTo - Paramètre facultatif. Date et heure utilisées pour interroger uniquement les événements WCF émis avant les valeurs définies.

MachineName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WCF générés sur l'ordinateur spécifié.

MaxResults - Paramètre facultatif. Nombre entier permettant de spécifier le nombre maximal de résultats affichés. La valeur par défaut est 50.

Server - Paramètre obligatoire. Chaîne spécifiant le serveur SQL à interroger.

SiteName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WCF générés sur le site spécifié.

VirtualPath - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WCF générés dans ou sous le chemin d'accès virtuel spécifié.

Chaînage

La cmdlet Get-ASAppTrackedWcfEvent peut être chaînée à partir de la cmdlet Get-ASAppService. Get-ASAppService renvoie un ApplicationObject qui peut être utilisé comme entrée pour Get-ASAppTrackedWcfEvent.

Exemples

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**

Cette cmdlet interroge la base de données de surveillance sur les données d'événement WF. Elle fonctionne sur toutes les étendues opérationnelles : ordinateur, site, application, service et chemin d'accès virtuel.

Syntaxe

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

Paramètres

Count - Paramètre facultatif. Indicateur ayant pour effet que la cmdlet renvoie un nombre d'événements WF correspondant aux critères spécifiés.

Database - Paramètre obligatoire. Chaîne spécifiant la base de données à interroger.

EmitTimeFrom - Paramètre facultatif. Date et heure utilisées pour interroger uniquement les événements WF émis postérieurement aux valeurs définies.

EmitTimeTo - Paramètre facultatif. Date et heure utilisées pour interroger uniquement les événements WF émis avant les valeurs définies.

MachineName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WF émis sur l'ordinateur spécifié.

MaxResults - Paramètre facultatif. Nombre entier permettant de spécifier le nombre maximal de résultats affichés. La valeur par défaut est 50.

Server - Paramètre obligatoire. Chaîne spécifiant le serveur SQL à interroger.

SiteName - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WF générés sur le site spécifié.

VirtualPath - Paramètre facultatif. Chaîne utilisée pour interroger uniquement les événements WF générés dans ou sous le chemin d'accès virtuel spécifié.

Chaînage

La cmdlet Get-ASAppTrackedWfEvent peut être chaînée à partir de la cmdlet Get-ASAppService. Get-ASAppService renvoie un ApplicationObject qui peut être utilisé comme entrée pour Get-ASAppTrackedWfEvent.

Exemple

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

Suppression de l'exemple

Pour supprimer cet exemple, supprimez les fichiers associés et rétablissez votre stratégie d'exécution sur son niveau précédent ou sur la valeur par défaut pour Windows PowerShell à l'aide de la commande suivante :

Set-ExecutionPolicy Default

  2011-12-05