Créer une activité PowerShell

Créez une activité PowerShell personnalisée pour 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
   Mappez les variables d’entrée	Utilisez les variables que vous avez créées pour configurer la commande qu’Orchestration exécute sur le MID Server.
   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 MID Server
   Fichier de script de MID Server	Le fichier de script MID Server contient les scripts PowerShell. Ce champ est disponible lorsque le type de script sélectionné est un fichier de script de MID Server.
   Commande	Commande PowerShell de l’activité exécutée. Ce champ est disponible lorsque le type de script sélectionné est Commande PowerShell personnalisée. Vous pouvez créer vos commandes en glissant-déplaçant 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 Value (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. Elles ne sont chiffrées que lorsqu’elles sont transférées dans la file d’attente ECC.
   Utiliser un compte de service MID	Si cette option est activée, cette activité s’authentifie sur l’hôte cible à l’aide des informations d’identification du compte de service du MID Server 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 MID Server essaie toutes les informations d’identification disponibles jusqu’à ce qu’il en trouve une valide, se terminant par le compte de service du MID Server. Si une balise d’informations d’identification est définie, le MID Server essaie les informations d’identification avec cette balise spécifiée uniquement et n’essaie pas le compte de service du MID Server. Remarque : Ce champ n’est pas disponible lorsque la case Utiliser le compte de service MID est cochée.
   Options requises de Serveur MID	Serveur MID à utiliser pour interroger PowerShell, par options. Par défaut, le système sélectionne un MID Server PowerShell.

   Remarque :

   Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties . Reportez-vous à la section Variables de sortie de mappage automatique.

Que faire ensuite

Terminez la création de votre activité PowerShell en créant des variables de sortie, en créant 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 des 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 des descriptions des champs de commande PowerShell, consultez la table de la section 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 : Commande: Commande PowerShell personnalisée. Fichier: Identifie le fichier de script de MID Server à exécuter.
Commande	commande	Chaîne	Commande envoyée au MID Server pour qu’il s’exécute sur l’hôte cible.
MidScriptFile (Fichier MidScript)	midScriptFile (Fichier de script intermédiaire)	Référence	sys_id de référence du fichier de script du MID Server à exécuter, lorsque l’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 MID	Fonctionnalités MID	Chaîne (séparée par des virgules)	Liste des options de MID Server requises.
Options de valeur	valueCapabilities (en anglais seulement)	Tableau de la carte de hachage	Valeurs d’aptitude utilisées pour sélectionner le MID Server. Pour plus d’informations, consultez Options du MID Server. Si des options supplémentaires sont affectées par valeur, utilisez cet exemple pour personnaliser la sélection du MID Server : var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability);

Analyse des paramètres de post-traitement et de la charge utile Powershell

Utilisez ces paramètres pour créer un script de post-traitement, une analyse de la 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 à renvoyer à 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 de pourcentage doubles, comme dans %%tagname%% ... %%. Configurez la commande en utilisant le format suivant dans 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 carte de hachage JavaScript dans lesquels chaque clé est préfixée par une balise accompagnée du nom de la balise. {"__text__": "", "tagtagname1":"output1 line1\noutput1 line2\n", "tagtagname2":"output2 line1\noutput2 line2\n"}
Hresult	Hresult	Chaîne	Contient tout résultat hresult retourné par la commande PowerShell. Si aucun résultat hn’est retourné, ce paramètre est nul.
Sortie	output	Chaîne	Contient la sortie brute de la commande PowerShell.
EccSysID (en anglais)	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 messages d’erreur.