Appeler Power Shell (Invoke Power Shell)

UiPath.Core.Activities.InvokePowerShell

Description

L'activité Invoke Power Shell exécute une commande ou un script PowerShell avec les paramètres d'entrée spécifiés.

Remarque : Les stratégies antivirus qui restreignent l'accès à PowerShell peuvent empêcher l'utilisation d'activités liées à PowerShell. Par exemple, vous ne pouvez pas utiliser Invoke Workflow File ni Invoke Power Shell lorsque l'ID de règle 6151 est activé dans McAfee Endpoint Security.

Compatibilité du Projet

Windows - Héritage | Fenêtres

Configuration

• Texte de commande (Command Text) : la commande PowerShell à exécuter. Cette valeur peut être le nom d'une cmdlet ou le texte d'un script PowerShell.

Panneau propriétés

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.
  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Paramètres (Parameters) : le dictionnaire des paramètres de la commande PowerShell. Une commande (cmdlet) ou un script spécifique peut être utilisé.
  • Commande spécifique : lorsque vous invoquez une commande spécifique, le nom du paramètre doit correspondre au nom du paramètre de la commande.
    Par exemple, si vous utilisez Get-Command -Module CimCmdlets comme entrée, la valeur d'entrée doit être Get-Command et le paramètre doit être nommé Module avec la valeur définie sur "CimCmdlets".
  • Script : au début du script, vous devez préciser le type du paramètre. En option, vous pouvez également rendre un paramètre obligatoire pour qu'un script soit toujours appelé avec le paramètre défini par l'appelant.
    Par exemple, le script suivant prend deux paramètres, l'un de type string, et l'autre de type int :

    Param(
       [Parameter(Mandatory=$true)]
       [string]$Name,
       [int]$Age
    )

    Ces paramètres peuvent ensuite être référencés dans le script en ajoutant $ devant le nom du paramètre.

• Entrée (Input) : une collection de PSObjects transmis à l'auteur du pipeline utilisé pour exécuter la commande. Peut être la sortie d'une autre activité InvokePowerShell. Vous pouvez référencer une entrée de pipeline dans un script en utilisant $input.
  Remarque : cette variable est créée implicitement par PowerShell. La définition de variables ou de paramètres nommés input peut générer des erreurs ou des conflits. Il est recommandé que le terme input soit réservé pour les pipelines.

Divers

• Mode d'exécution (Execution mode) : sélectionnez une version de PowerShell dans laquelle exécuter la commande ou le script fourni. Ceci n'est disponible que pour les projets Windows, les projets Windows-Legacy ciblent la version Windows PowerShell 5.1 (32 bits).

  Les options suivantes sont disponibles :

  • PowerShell 7.2 (64 bits) : utilise le shell PowerShell Core basé sur .NET6. Dans cette version, PowerShell est hébergé dans le runtime .NET 6. Toutes les données utilisées sont directement accessibles par l'activité et peuvent être importées dans le workflow.
  • PowerShell 5.1 (64 bits) : utilise l'exécutable Windows PowerShell 64 bits. Dans cette version, PowerShell est fourni avec Windows et est situé par défaut dans C:\Windows\System32\WindowsPowerShell\v1.0\. Dans ce mode d'exécution, PowerShell est distant localement sur la machine à l'aide du shell préinstallé. La mise à distance introduit le besoin de sérialiser et de désérialiser les informations entre les différents runtimes .NET, et de ce fait, les objets qui ne peuvent pas être reconstruits sont encapsulés dans un PSObject ou PSCustomObject.
  • PowerShell 5.1 (32 bits) : utilise l'exécutable Windows PowerShell 32 bits. Dans cette version, PowerShell est fourni avec Windows et est situé par défaut dans C:\Windows\SysWOW64\WindowsPowerShell\v1.0\). Dans ce mode d'exécution, PowerShell est distant localement sur la machine à l'aide du shell préinstallé. La mise à distance introduit le besoin de sérialiser et de désérialiser les informations entre les différents runtimes .NET, et de ce fait, les objets qui ne peuvent pas être reconstruits sont encapsulés dans un PSObject ou PSCustomObject. PSObject et PSCustomObjects contiennent des informations sur la structure globale de l'objet d'origine et peuvent être utilisés pour reconstruire les objets manuellement.
• EstScript (IsScript) : permet d'indiquer si le texte de la commande est un script ou une commande directe. Les Pipelines, Variables et Paramètres peuvent être utilisés avec une seule commande ou script.
• VariablesPowerShell (PowerShellVariables) : un dictionnaire d'objets nommés représentant les variables utilisées dans la session en cours de l'activité InvokePowerShell. Une commande ou un script PowerShell peut récupérer des informations à partir des variables In et In/Out et peut définir des variables Out. Pour référencer des variables dans votre script, utilisez le caractère identificateur de variable $ pour indiquer que le texte suivant est un nom de variable. Exemple : $firstVariable.
  Remarque : les noms de variables ne sont pas sensibles à la casse.
• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).
• Argument de type (TypeArgument) - Définit le type de la variable de sortie.

Sortie

• Sortie (Output) - Collection d'objets TypeArgument renvoyés par l'exécution de la commande. Peut être utilisée pour acheminer plusieurs activités InvokePowerShell.