--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Créer une activité PowerShell # Créer une activité PowerShell {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture 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](https://servicenow-prod.fluidtopics.net/8fMcXxzqX9_ulMMl1iJpXg "Vous pouvez créer et mettre à jour différents types d’activités personnalisées dans l’Éditeur de workflow à l’aide d’un modèle personnalisé."). 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](https://servicenow-prod.fluidtopics.net/0gDo_2~KCA81l7h1863MYg "Les champs Propriété générale suivants sont communs à tous les modèles du concepteur d’activité.") et [créé des variables d'entrée](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#CreateInputVariables "Créez les variables à transmettre dans l’activité dans le formulaire Entrées du concepteur d’activité."), configurez la commande d'exécution PowerShell. | Option | Description | | [Mapper les variables d'entrée](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#t_MapAnInputVariable "Après avoir créé les variables d’entrée, mappez-les aux champs du formulaire Commande d’exécution.") | 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 {#t_CreateAPowershellActivity__ul_bsj_mzp_vz} | | Fichier de script de serveur MID | Le fichier de script du serveur MID contient les scripts PowerShell. Ce champ est disponible lorsque le type de script sélectionné est un 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é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 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 passent dans 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 balise spécifiée uniquement, et n'essaie pas le compte de service du serveur MID. Remarque : Ce champ n'est pas disponible lorsque la case Utiliser le compte de service MID est cochée. | | Capacités du serveur MID requises | Serveur MID à utiliser pour interroger PowerShell, par options. Par défaut, le système sélectionne un serveur MID PowerShell. | |-|-| {#t_CreateAPowershellActivity__choicetable_asj_mzp_vz} 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](https://servicenow-prod.fluidtopics.net/uMEyrHZXhc5El5pzZ3u4~A "Vous pouvez mapper automatiquement les valeurs des paramètres d’une charge utile de test aux variables de l’onglet Sorties ."). ## Que faire ensuite Terminez la création de votre activité PowerShell [en créant des variables de sortie](https://servicenow-prod.fluidtopics.net/7ft7SbY6rbkRkSKzg4NOSg#t_CreateAnOutputVariable "Le formulaire Sorties du concepteur contient un générateur de variables permettant de créer des structures de données d’objets et de tableaux."), [une règle d'analyse ou des](https://servicenow-prod.fluidtopics.net/MvPjfPwcbqm1MnFZeco_Tg#t_CreateAParsingRule "Renseignez les variables de sortie définies dans une activité personnalisée avec les données de charge utile renvoyées par un test d’entrées sur un hôte ou un point de terminaison externe.")[conditions](https://servicenow-prod.fluidtopics.net/4HCSob07z95KIGZCnb~e2w "Créez les conditions de sortie de votre activité dans la colonne Condition et définissez l’ordre de chacune."). Consultez la rubrique [Créer des activités personnalisées](https://servicenow-prod.fluidtopics.net/8fMcXxzqX9_ulMMl1iJpXg "Vous pouvez créer et mettre à jour différents types d’activités personnalisées dans l’Éditeur de workflow à l’aide d’un modèle personnalisé.") pour connaître vos options de modèle. ## Paramètres d'exécution du modèle PowerShell {#ariaid-title2} 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, consultez le tableau dans [Configurer la commande d'exécution PowerShell](https://servicenow-prod.fluidtopics.net/fvDkuvTWTtwpaPa5ll8Q4g#t_MapPowershellVariablesToExecCmd "Utilisez les variables d’entrée que vous avez créées pour configurer la commande qu’Orchestration exécute sur l’ordinateur cible Windows."). Remarque : Vous devez utiliser le préfixe `executionParam.` avec toutes les variables de cette table. {#r_PshellTmpltExctnPrm__table_b2b_jw5_cr__entry__4} | 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 du serveur MID à exécuter. {#r_PshellTmpltExctnPrm__ul_fz2_nw5_cr} | | Commande | commande | Chaîne | Commande envoyée au serveur MID pour qu'il s'exécute sur l'hôte cible. | | Fichier MidScriptFile | midScriptFile | Référence | sys_id de référence du fichier de script du serveur MID à exécuter, lorsque le script_type est 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. | | ValueCapabilities | valueCapabilities | Tableau de la carte de hachage | Valeurs d'aptitude utilisées pour sélectionner le serveur MID. Pour plus d'informations, voir [Options du serveur MID](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=australia&pubname=australia-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US). 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); | [Tableau 1. Exécution Powershell Paramètres] {#r_PshellTmpltExctnPrm__table_b2b_jw5_cr} ## Paramètres de post-traitement Powershell et analyse de la charge utile {#ariaid-title3} Utilisez ces paramètres pour créer un script de post-traitement, une analyse de charge utile et un balisage. {#powershell-payload-parsing-tags__table_grr_t2v_cr__entry__4} | Nom | Variable | Type | Utilisation | |-|-|-|-| | Étiquettes | étiquettes | 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 à l'aide du format 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 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 | Chaîne | Contient tout hresult renvoyé 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 | errorMessages | Chaîne | Contient tous les messages d'erreur récupérés à partir de la commande PowerShell. Cette valeur est nulle en l'absence de message d'erreur. | [Tableau 2. Paramètres de post-traitement Powershell] {#powershell-payload-parsing-tags__table_grr_t2v_cr}