Partager via

Résoudre les problèmes d’exécution des runbooks lors de l’utilisation de PowerShell dans Azure Automation

Cet article fournit des conseils sur le diagnostic et la résolution des problèmes d’exécution de runbooks qui se produisent lors de l’utilisation de scripts ou d’applets de commande PowerShell dans Azure Automation.

Remarque

Azure Automation permet la récupération des runbooks supprimés au cours des 29 derniers jours. Vous pouvez restaurer un runbook supprimé en exécutant un script PowerShell en tant que travail dans votre compte Automation. Pour plus d'informations, consultez Restaurer un runbook supprimé.

Limitations et problèmes connus liés aux runbooks PowerShell

Les runbooks PowerShell sont basés sur Windows PowerShell. Vous pouvez modifier leur code directement à l’aide de l’éditeur de texte dans le portail Azure. Vous pouvez également utiliser un éditeur de texte hors connexion, puis importer les runbooks dans Azure Automation. La version de PowerShell est déterminée par la version runtime spécifiée.

Limitations :

  • Dans la version de runtime PowerShell 7, les activités du module ne sont pas extraites pour les modules importés.
  • Le type de paramètre de runbook PSCredential n’est pas pris en charge dans la version de runtime PowerShell 7.
  • PowerShell 7.x ne prend pas en charge les runbooks de flux de travail. Pour plus d’informations, consultez le flux de travail PowerShell.
  • PowerShell 7.x ne prend pas en charge les runbooks signés pour le moment.
  • L’intégration du contrôle de code source ne prend pas en charge PowerShell 7.2. Les runbooks PowerShell 7.2 dans la gestion du code source sont créés dans un compte Automation en tant qu'environnement d'exécution 5.1.
  • Actuellement, seuls les travaux cloud sont pris en charge pour la version du runtime PowerShell 7.2.
  • L’utilisation de modules Az et AzureRM dans le même compte Automation n’est pas prise en charge. Pour plus d’informations, consultez Mettre à jour les modules Azure PowerShell dans Automation.

Problèmes connus :

  • Les propriétés de runbook définissant la préférence de journalisation ne sont pas prises en charge dans le runtime PowerShell 7.

    Pour contourner ce problème, définissez explicitement la préférence au début du runbook comme suit :

    $VerbosePreference = "Continue"
$ProgressPreference = "Continue"

  • Lorsque vous utilisez le module ExchangeOnlineManagement version 3.0.0 ou ultérieure, vous pouvez rencontrer des erreurs.

    Pour résoudre ce problème, veillez à charger explicitement les modules PowerShellGet et PackageManagement.

Avant la résolution des problèmes

Suivez ces étapes pour identifier et résoudre les erreurs courantes avant de résoudre les problèmes suivants :

  1. Vérifiez que votre script PowerShell fonctionne en dehors d’Azure Automation.
  2. Vérifiez que les modules requis sont importés dans votre compte Azure Automation.

Problème 1 : Échec de l’exécution du Runbook en raison d’un objet désérialisé

Symptômes :

Lorsque vous exécutez un runbook, le message d’erreur suivant peut s’afficher :

Impossible de lier le paramètre <ParameterName>.

Impossible de convertir la <valeur ParameterType> du type ParameterType> désérialisé <en type <ParameterType>.

Cause :

Cette erreur se produit avec les runbooks powerShell Workflow, car PowerShell Workflow stocke des objets complexes dans un format désérialisé pour conserver l’état de votre runbook lorsque le flux de travail est suspendu.

Résolution :

Pour résoudre ce problème, utilisez l’une des méthodes suivantes :

  • Si vous dirigez des objets complexes d’une applet de commande PowerShell vers un autre, encapsulez ces applets de commande dans une InlineScript activité.
  • Transmettez le nom ou la valeur dont vous avez besoin depuis l’objet complexe au lieu de transmettre la totalité de l’objet.
  • Utilisez un runbook PowerShell au lieu d’un runbook de workflow PowerShell.

Problème 2 : Échec des travaux PowerShell avec l’erreur « Impossible d’appeler la méthode »

Symptômes :

Lorsque vous démarrez un travail PowerShell dans un runbook qui s’exécute dans un bac à sable Azure, vous recevez le message d’erreur suivant :

Exception levée : impossible d’appeler la méthode. L’appel de méthode n'est pris en charge que sur les types de base dans ce mode de langue.

Cause :

Cette erreur peut se produire, car le runbook ne peut pas s’exécuter en mode Langue complète.

Résolution :

Pour résoudre cette erreur, utilisez l’une des méthodes suivantes :

Référence

Contactez-nous pour obtenir de l’aide

Si vous avez des questions ou avez besoin d’aide, créez une demande de support ou demandez le support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.