Analyses de script et de règles

Les scripts d'analyse d'envoi des données de sortie comme une propriété de jeu afin qu'il peut être évaluée dans une expression pour une analyse ou mappé sur les données de performances ou un événement pour une règle de collecte. Un jeu de propriétés est un ensemble de valeurs ayant chacune un nom. Bien qu'il soit recommandé d'utiliser un nom descriptif de la valeur particulière, vous pouvez affecter n'importe quel nom. Un jeu de propriétés n'existe que pendant la durée de vie du flux de travail. La prochaine fois que le workflow s'exécute, le script s'exécute et crée un nouveau jeu de propriétés avec les nouvelles valeurs.

Un sac de propriétés peut avoir des valeurs numériques, bien que l'ensemble des données ne peut pas dépasser 4 Mo. La plupart des scripts ne nécessite que quelques valeurs avec une taille totale présent sous cette limite. Il est inutile de toutes les valeurs à utiliser par le workflow.

Scripts créent des conteneurs de propriétés à l'aide de la méthode CreatePropertyBag MOM. Objet ScriptAPI. Le flux de travail utilise les valeurs d'un jeu de propriétés avec une variable $Data qui utilise la syntaxe suivante :

$Data/Property[@Name="PropertyName"]

Par exemple, un script permettant de créer des données de performances peut créer un jeu de propriétés avec des valeurs dans le tableau suivant. Ce tableau indique le nom de la valeur créée par le script et la variable $Data correspondante qui serait utilisée pour mapper les données de sac de propriété pour les données de performances.

Le code suivant illustre un exemple de script pour illustrer la structure de base d'un script d'analyse d'analyse. Cet exemple de script a les caractéristiques suivantes.

• Accepte des arguments pour le nom de l'ordinateur qui exécute le script et un chemin d'accès de l'emplacement de l'application.

• Crée un jeu de propriétés avec les valeurs nommées ComputerName InstanceName et PerfValue.

sComputerName = WScript.Arguments(0) 
sApplicationPath = WScript.Arguments(1)

Set oAPI = CreateObject("MOM.ScriptAPI")
Set oBag = oAPI.CreatePropertyBag()

oBag.AddValue "ComputerName", sComputerName
oBag.AddValue "InstanceName", "MyInstance"
oBag.AddValue "Value", 1.0

oAPI.Return(oBag)

Détails de chaque section du script sont décrites ici.

sComputerName = WScript.Arguments(0) 
sApplicationPath = WScript.Arguments(1)

Les deux premières lignes du script acceptent des arguments. Ces valeurs susceptibles d'être dans le paramètre d'Arguments de la règle ou l'analyse de l'exécution du script. Le script peut utiliser n'importe quel nombre d'arguments qui sont requis pour la logique du script.

Set oAPI = CreateObject("MOM.ScriptAPI")
Set oBag = oAPI.CreatePropertyBag()

Les deux lignes de créer un jeu de propriétés. Ces lignes également reste la même dans la plupart des scripts d'analyse. L'objectif principal du reste du script sera pour ajouter des valeurs pour le jeu de propriétés à l'aide des données collectées à partir de l'ordinateur agent.

oBag.AddValue "ComputerName", sComputerName
oBag.AddValue "InstanceName", "MyInstance"
oBag.AddValue "Value", 1.0

Une fois le jeu de propriétés est créé, n'importe quel nombre de valeurs peut être ajouté. Pour ce faire le AddValue méthode sur l'objet de sac de propriété en utilisant le nom de l'élément suivi sa valeur. Cet exemple utilise des valeurs explicites. Dans le script d'analyse réelle, code supplémentaire susceptibles de qui serait collecter des informations à partir de l'ordinateur agent à inclure dans ces valeurs.

oAPI.Return(oBag)

Une fois que toutes les valeurs sont ajoutées au jeu de propriétés, il est retourné dans le flux de travail. Cette ligne est requise, et sans lui, le jeu de propriétés est ignoré lorsque le script se termine. Cette méthode est utilisée uniquement lorsque le script crée uniquement un jeu de propriétés unique. Pour plus d'informations sur les scripts qui retournent plusieurs jeux de propriétés et les conditions lorsque cette stratégie est utilisée, reportez-vous à la Cookdown section de la Guide de création de System Center Operations Manager 2007 R2.

La plupart des scripts utilisent des arguments qui sont des valeurs qui sont envoyés vers le script à partir de la ligne de commande lorsque le script est exécuté. À l'aide d'arguments permet à un seul script à utiliser pour plusieurs scénarios sans modifier le script lui-même.

Dans un script d'analyse, les arguments sont critiques, car il peut y avoir des informations requises par le script qui sera différent sur chaque agent où le script s'exécute. N'importe quelle propriété de l'objet cible pour l'analyse ou la règle peut être utilisée pour la valeur d'un argument de script. Cette valeur est résolue individuellement sur chaque agent au moment de l'exécution du script.

Arguments sont accessibles dans la console opérateur à partir de la paramètres bouton. Arguments individuels doivent être séparées par des espaces dans l'ordre qu'ils sont accessibles dans le script. Cela est identique à la ligne de commande qui serait fournie si le script était exécuté sur une ligne de commande.

Chaque argument peut être une valeur explicite ou une variable $Target pour utiliser la valeur d'une propriété sur l'objet cible. Toutes les variables $Target sont résolues lors de l'exécution du script afin que le script est fourni avec les valeurs résolues sur la ligne de commande. Vous pouvez taper dans la variable $Target si vous connaissez la syntaxe correcte. Il est cependant plus facile pour sélectionner la propriété à partir de cible bouton qui répertorie toutes les propriétés de l'objet cible et de ses parents.

Par exemple, l'exemple de script précédent attend deux arguments pour le nom d'ordinateur et le chemin d'accès de l'application. En supposant que cela faisait partie d'une analyse ou une règle ciblée sur une classe hébergée par le ordinateur Windows classe, l'ordinateur nom peut être récupéré de la propriété nom principal. Si le chemin d'accès de l'application avait une propriété sur la classe cible, puis les arguments peuvent ressembler à l'exemple suivant. Remarquez les guillemets autour de la propriété ApplicationPath, car cela pourrait résoudre vers une valeur qui contient un espace.

$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/PrincipalName$ "$Target/Property[Type="MyApp.MyClass"]/ApplicationPath$"

En supposant que vous avez attribué le script pour un nom de MyScript.vbs, le nom de l'ordinateur a été MyServer01, et le chemin d'accès de l'application a été C:\Program Files\Contoso\My Application, la ligne de commande qui doit être exécutée pour ce script serait :

MyScript.vbs MyServer01 "C:\Program Files\Contoso\My Application"

• Règles de collecte de script

  Création d'une règle qui utilise un script pour collecter des données d'événement ou de performances.

• Analyse de script

  Création d'une analyse qui évalue les résultats d'un script pour définir son état d'intégrité.

• Analyses de commande Shell UNIX/Linux

  Création d'une analyse qui évalue la sortie de l'exécution d'une commande UNIX/Linux, le script ou la séquence d'une ligne de plusieurs commandes (à l'aide d'opérateurs pipeline).