Créer une activité PowerShell

Créer une activité PowerShell personnalisée Renvoyer des données à un workflow à partir d’un hôte à l’aide de Microsoft PowerShell.

Avant de commencer

Rôle requis : activity_creator ou workflow_admin

Pourquoi et quand exécuter cette tâche

ServiceNow prend en charge PowerShell 3.0 à 5.1.

Procédure

1. Créez une activité personnalisée.
   Cette action crée une activité personnalisée à l’aide d’un modèle.
2. Après avoir configuré les propriétés générales et créé des variables d’entrée, configurez la commande d’exécution PowerShell.

   Option	Description
   Mapper les variables d’entrée	Utilisez les variables que vous avez créées pour configurer la commande qu’Orchestration exécute sur le Serveur MID.
   Hôte cible	Nom d’hôte ou adresse IP du serveur cible pour cette activité PowerShell.
   Type de script	Type de script PowerShell à exécuter sur l’hôte PowerShell. Options disponibles : Commande PowerShell personnalisée Fichier de script de Serveur MID
   Fichier de script de Serveur MID	Le fichier de script de Serveur MID contient les scripts PowerShell. Ce champ est disponible lorsque le type de script sélectionné est Fichier de script Serveur MID.
   Commande	Commande PowerShell exécutée par l’activité. Ce champ est disponible lorsque le type de script sélectionné est une commande PowerShell personnalisée. Vous pouvez créer vos commandes en faisant glisser et en déposant des variables d’entrée du générateur de variables dans ce champ.
   Variables PowerShell	Paires nom-valeur à transmettre à l’hôte avec PowerShell. Vous pouvez créer ces variables manuellement ou faire glisser les variables d’entrée dans le champ Valeur . Les variables d’entrée chiffrées conservent leur chiffrement, quels que soient les paramètres de type de données dans ce champ. Si vous saisissez une valeur et sélectionnez le type de données chiffrées , votre valeur s’affiche en texte brut. Il n’est chiffré que lorsqu’il passe à la file d’attente ECC.
   Utiliser un compte de service MID	Si cette option est cochée, cette activité s’authentifie sur l’hôte cible à l’aide des informations d’identification du compte de service de Serveur MID uniquement, sans essayer d’autres informations d’identification. Remarque : Le champ Balise d’informations d’identification n’est pas disponible.
   Balise d’informations d’identification	Balise d’informations d’identification que cette activité doit utiliser pour exécuter les commandes PowerShell sur l’hôte. Si ce champ est laissé vide, le Serveur MID essaie toutes les informations d’identification disponibles jusqu’à ce qu’il en trouve une valide, en terminant par le compte de service du Serveur MID. Si une balise d’informations d’identification est définie, le Serveur MID teste les informations d’identification avec cette seule balise spécifiée et n’essaie pas le compte de service de Serveur MID. Remarque : Ce champ n’est pas disponible lorsque la case Utiliser le compte de service MID est cochée.
   Capacités de Serveur MID requises	Serveur MID à utiliser pour interroger PowerShell, par options. Par défaut, le système sélectionne un Serveur MID PowerShell.

   Remarque :

   Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties . Voir variables de sortie de mappage automatique.

Que faire ensuite

Terminez la création de votre activité PowerShell en créant des variables de sortie, une règle d’analyse ou desconditions. Reportez-vous à la rubrique Créer des activités personnalisées pour connaître les options de votre modèle.

Paramètres d’exécution du modèle PowerShell

Vous utilisez les paramètres d’exécution pour créer le script de processus d’entrée dans le formulaire Prétraitement du concepteur d’activité.

Pour obtenir une description des champs de commande Powershell, reportez-vous au tableau dans Configurer la commande d’exécution PowerShell.

Remarque :

Vous devez utiliser le préfixe executionParam. avec toutes les variables de cette table.

Tableau 1. Exécution Powershell Paramètres

Nom	Variable	Type	Utilisation
Source	source	Chaîne	Hôte cible sur lequel exécuter la commande.
Type de script	script_type	Énumération	Type de script à exécuter. Les types possibles sont les suivants : commander: Commande PowerShell personnalisée. lime: Identifie le fichier de script du Serveur MID à exécuter.
Commande	commande	Chaîne	Commande envoyée au Serveur MID pour qu’il s’exécute sur l’hôte cible.
Fichier MidScript	midScriptFile	Référence	sys_id de référence du fichier de script de Serveur MID à exécuter, lorsque le script_type est un fichier.
Variables Powershell	Variables PowerShell	Tableau de la carte de hachage	Carte de hachage des objets JavaScript avec le nom, la valeur et le type de chaque objet. Le type de chaque objet peut être brut, chiffré, booléen ou nul, correspondant au type de variable PowerShell sélectionné dans l’onglet entrées. Par exemple, vous pouvez saisir : var newParameter = {"name":"parameterName","value":"parameterValue", "type": "plain" }; executionParam.powershellVariables.push(newParameter);
Balise d’informations d’identification	credential_tag	Chaîne	Balise d’informations d’identification spécifique que cette activité doit utiliser pour exécuter les commandes PowerShell sur l’hôte.
Capacités moyennes	midCapabilities	Chaîne (séparée par des virgules)	Liste des options de Serveur MID requises.
ValeurCapacités	valueCapabilities	Tableau de la carte de hachage	Valeurs d’aptitude utilisées pour sélectionner le Serveur MID. Pour plus d’informations, voir Aptitudes du serveur MID. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection de Serveur MID : var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability);

Paramètres de post-traitement Powershell et analyse de la charge utile

Utilisez ces paramètres pour créer un script de post-traitement, une analyse de charge utile et un balisage.

Tableau 2. Paramètres de post-traitement Powershell

Nom	Variable	Type	Utilisation
Balises	balises	Carte de hachage des valeurs de balises à retourner à partir de la commande PowerShell.	Contient les balises utilisées pour extraire la sortie à l’aide des commandes PowerShell. La sortie de la balise est délimitée par des signes à double pourcentage, comme dans %%tagname %% ... %%. Configurez la commande en utilisant le format de cet exemple : Write-Host %%tagname1%% output1 line 1 output1 line 2 … Write-Host%% Write-Host %%tagname2%% output2 line 1 output2 line 2 … Write-Host%% Les balises renvoyées sont des objets de hashmap JavaScript dans lesquels chaque clé est précédée d’une balise accompagnée du tagname. {"__text__": "", "tagtagname1":"output1 line1\noutput1 line2\n", "tagtagname2":"output2 line1\noutput2 line2\n"}
Résultat Hresult	hresult	Chaîne	Contient tout hresult retourné par la commande PowerShell. Si aucun hresult n’est renvoyé, ce paramètre est nul.
Sortie	sortie	Chaîne	Contient la sortie brute de la commande PowerShell.
EccSysID	eccSysID	Chaîne	Contient l’ID de référence associé au message d’entrée de file d’attente ECC renvoyé par l’activité.
Messages d’erreur	Messages d’erreur	Chaîne	Contient tous les messages d’erreur récupérés à partir de la commande PowerShell. Cette valeur est nulle s’il n’y a pas de message d’erreur.