Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article décrit comment mettre à jour les modules Azure PowerShell (Az) dans Azure Automation. Le module Az PowerShell est un ensemble d’applets de commande permettant de gérer des ressources Azure directement à partir de PowerShell. Azure Automation fournit par défaut des modules PowerShell courants dans chaque compte Automation. Pour plus d’informations, voir Modules par défaut. À mesure que l’équipe Azure met à jour régulièrement les modules Azure, les modifications peuvent se produire avec les applets de commande incluses. Par exemple, renommer un paramètre ou déprécier complètement un cmdlet. Ces changements peuvent affecter les runbooks et les processus d’automatisation existants si les modules ne sont pas mis à jour en conséquence. Pour aider à gérer ces mises à jour, Azure Automation propose deux méthodes pour mettre à jour les modules Az :
Remarque
Vous ne pouvez pas supprimer des modules globaux, qui sont des modules prêts à l’emploi fournis par Automation.
Important
La nouvelle expérience d’environnement Runtime vous permet de gérer des modules et des packages en vous autorisant à configurer l’environnement d’exécution du travail. Dans la nouvelle expérience, les volets Modules et Packages ne sont pas disponibles. Pour gérer des modules et des packages, consultez Gérer l’environnement Runtime et les runbooks associés.
Configurer un compte Automation
Pour éviter toute incidence sur vos runbooks et sur les processus qu’ils automatisent, veillez à tester et valider les mises à jour. Si vous n’avez pas de compte Automation dédié destiné à cet usage, créez-en un pour pouvoir tester différents scénarios pendant le développement de vos runbooks. Ces tests doivent comprendre des changements itératifs, comme la mise à jour des modules PowerShell.
Vérifiez que votre compte Automation a ajouté une identité managée affectée par le système ou une identité managée affectée par l’utilisateur.
Si vous développez vos scripts localement, il est recommandé de disposer localement des mêmes versions de module que celles disponibles dans votre compte Automation à des fins de test, pour être assuré d’obtenir les mêmes résultats. Après validation des résultats et application des modifications nécessaires, vous pouvez transférer les modifications en production.
Remarque
Un nouveau compte Automation peut ne pas contenir les derniers modules.
Mettre à jour les modules Az
Les sections suivantes expliquent comment mettre à jour les modules Az soit via le portail (recommandé), soit via le runbook.
Mettre à jour les modules Az via le portail Azure
Actuellement, la mise à jour des modules Az n’est disponible que via le portail. Les mises à jour par le biais de PowerShell et du modèle ARM seront disponibles à l’avenir. Seuls les modules Az par défaut sont mis à jour lors de l’exécution des étapes suivantes :
Connectez-vous au portail Azure et accédez à votre compte Automation.
Sous Ressources partagées, sélectionnez Modules.
Sélectionnez Mettre à jour les modules Az.
Sélectionnez Module à mettre à jour. Par défaut, il affiche le module Az.
Dans la liste déroulante, sélectionnez Version du module et Version Runtime.
Sélectionnez Mettre à jour pour mettre à jour le module Az à la version que vous avez sélectionnée. Dans la page Modules, vous pouvez voir la liste, comme illustré ci-dessous :
Si vous sélectionnez une version inférieure à la version existante du module Az importée dans le compte Automation, l’opération de mise à jour effectue une restauration vers la version inférieure sélectionnée.
Vous pouvez vérifier l’opération de mise à jour en activant la propriété Version et état du module dans la liste de modules sous Modules PowerShell.
L’équipe Azure met régulièrement à jour la version du module et propose une option pour mettre à jour les modules Az par défaut en sélectionnant la version du module dans la liste déroulante.
Mettre à jour les modules Az via runbook
Pour mettre à jour les modules Azure dans votre compte Automation :
- Utilisez le runbook Update-AutomationAzureModulesForAccount disponible en tant que open source.
- Téléchargez à partir du référentiel GitHub pour commencer à utiliser ce runbook pour mettre à jour vos modules Azure.
- L’importer dans votre compte Automation ou l’exécuter en tant que script. Pour savoir comment importer un runbook dans votre compte Automation, consultez Importer un runbook.
Remarque
Nous vous recommandons de mettre à jour les modules Az via Azure portail. Vous pouvez également effectuer cette opération à l’aide du script Update-AutomationAzureModulesForAccount, disponible en tant qu’open source et fournie en tant que référence. Toutefois, en cas d’échec de runbook, vous devez modifier des paramètres dans le runbook selon les besoins ou déboguer le script en fonction du scénario.
Le runbook Update-AutomationAzureModulesForAccount prend en charge la mise à jour des modules Azure, AzureRM et Az par défaut. Consultez le fichier Lisez-moi du runbook Mettre à jour les modules Azure pour plus d’informations sur la mise à jour d’Az. Modules d’automatisation avec ce runbook. Il y a d’autres facteurs importants que vous devez prendre en compte lorsque vous utilisez les modules Az dans votre compte Automation. Pour plus d’informations, consultez les modules Manage dans Azure Automation.
Utilisez le code runbook de mise à jour comme script PowerShell standard
Vous pouvez utiliser le code de runbook comme un script PowerShell ordinaire plutôt que comme runbook. Pour cela, connectez-vous à Azure en utilisant d’abord le cmdlet Connect-AzAccount, puis passez -Login $false au script.
Utiliser le runbook de mise à jour sur des clouds souverains
Pour utiliser ce runbook sur des clouds souverains, utilisez le paramètre AzEnvironment pour transmettre l’environnement approprié au runbook. Les valeurs acceptables sont AzureCloud (Azure cloud public), AzureChinaCloud, AzureGermanCloud et AzureUSGovernment. Vous pouvez récupérer ces valeurs en utilisant Get-AzEnvironment | select Name. Si vous ne transmettez pas de valeur à cette cmdlet, la valeur par défaut du runbook est AzureCloud.
Utiliser le runbook de mise à jour pour mettre à jour une version de module spécifique
Si vous souhaitez utiliser une version de module Azure PowerShell spécifique au lieu du dernier module disponible sur le PowerShell Gallery, transmettez ces versions au paramètre facultatif ModuleVersionOverrides du runbook Update-AutomationAzureModulesForAccount. Pour obtenir des exemples, consultez le runbook Update-AutomationAzureModulesForAccount.ps1. Azure PowerShell modules qui ne sont pas mentionnés dans le paramètre ModuleVersionOverrides sont mis à jour avec les dernières versions des modules sur la galerie PowerShell. Si vous ne transmettez rien au paramètre ModuleVersionOverrides, tous les modules sont mis à jour avec les dernières versions de module sur le PowerShell Gallery. Ce comportement est le même pour le bouton Update Azure Modules dans le portail Azure.
Étapes suivantes
- Pour plus de détails sur l’utilisation des modules, voir Gérer les modules dans Azure Automation.
- Pour plus d’informations sur le runbook de mise à jour, consultez Runbook Mettre à jour les modules Azure.
- Pour résoudre les problèmes de mise à jour de modules Azure PowerShell gérés en tant que ressources partagées dans Azure Automation, consultez Troubleshoot Azure Automation problèmes de ressources partagées.