Utiliser l’extension Azure Policy pour Visual Studio CodeUse Azure Policy extension for Visual Studio Code

S’applique à l’extension Azure Policy 0.0.21 et aux versions ultérieures.Applies to Azure Policy extension version 0.0.21 and newer

Découvrez comment utiliser l’extension Azure Policy pour Visual Studio Code afin de rechercher des alias et de vérifier les ressources et les stratégies.Learn how to use the Azure Policy extension for Visual Studio Code to look up aliases and review resources and policies. Tout d’abord, nous décrirons comment installer l’extension Azure Policy dans Visual Studio Code.First, we'll describe how to install the Azure Policy extension in Visual Studio Code. Ensuite, nous étudierons comment rechercher des alias.Then we'll walk through how to look up aliases.

L’extension Azure Policy pour Visual Studio Code peut être installée sur toutes les plateformes prises en charge par Visual Studio Code :Azure Policy extension for Visual Studio Code can be installed on all platforms that are supported by Visual Studio Code. Windows, Linux et macOS.This support includes Windows, Linux, and macOS.

Notes

Les modifications apportées localement aux stratégies qui s’affichent dans l’extension Azure Policy pour Visual Studio Code ne sont pas synchronisées avec Azure.Changes made locally to policies viewed in the Azure Policy extension for Visual Studio Code aren't synced to Azure.

PrérequisPrerequisites

Avant de poursuivre cet article, vérifiez que vous avez les éléments nécessaires suivants :The following items are required for completing the steps in this article:

Installer l’extension Azure PolicyInstall Azure Policy extension

Une fois tous les prérequis remplis, vous pouvez installer l’extension Azure Policy pour Visual Studio Code en suivant les étapes ci-dessous :After you meet the prerequisites, you can install Azure Policy extension for Visual Studio Code by following these steps:

  1. Ouvrez Visual Studio Code.Open Visual Studio Code.

  2. À partir de la barre de menus, accédez à Afficher > Extensions.From the menu bar, go to View > Extensions.

  3. Dans la zone de recherche, entrez Azure Policy.In the search box, enter Azure Policy.

  4. Sélectionnez Azure Policy dans les résultats de la recherche, puis sélectionnez Installer.Select Azure Policy from the search results, and then select Install.

  5. Sélectionnez Recharger si nécessaire.Select Reload when necessary.

Configurer l’environnement AzureSet the Azure environment

Dans le cas d’un utilisateur d’un cloud national, suivez d’abord ces étapes pour configurer l’environnement Azure :For a national cloud user, follow these steps to set the Azure environment first:

  1. Sélectionnez File\Preferences\Settings.Select File\Preferences\Settings.

  2. Recherchez la chaîne suivante : Azure : CloudSearch on the following string: Azure: Cloud

  3. Sélectionnez le cloud national dans la liste :Select the nation cloud from the list:

    Définir la connexion au cloud Azure par défaut pour Visual Studio Code

Se connecter à un compte AzureConnect to an Azure account

Pour pouvoir évaluer des ressources et rechercher des alias, vous devez vous connecter à votre compte Azure.To evaluate resources and lookup aliases, you must connect to your Azure account. Suivez ces étapes pour vous connecter à Azure à partir de Visual Studio Code :Follow these steps to connect to Azure from Visual Studio Code:

  1. Connectez-vous à Azure à partir de l’extension Azure Policy ou de la palette de commandes.Sign in to Azure from the Azure Policy extension or the Command Palette.

    • Extension Azure PolicyAzure Policy extension

      À partir de l’extension Azure Policy, sélectionnez Se connecter à Azure.From the Azure Policy extension, select Sign in to Azure.

      Connexion au cloud Azure pour Visual Studio Code à partir de l’extension Azure Policy

    • Palette de commandesCommand Palette

      À partir de la barre de menus, accédez à Afficher > Palette de commandes, puis entrez Azure: Se connecter.From the menu bar, go to View > Command Palette, and enter Azure: Sign In.

      Connexion au cloud Azure pour Visual Studio Code à partir de la palette de commandes

  2. Suivez les instructions de connexion pour vous connecter à Azure.Follow the sign in instructions to sign in to Azure. Une fois que vous êtes connecté, le nom de votre compte Azure s’affiche dans la barre d’état, en bas de la fenêtre Visual Studio Code.After you're connected, your Azure account name is shown on the status bar at the bottom of the Visual Studio Code window.

Sélectionner des abonnementsSelect subscriptions

Lors de la première connexion, seules les stratégies et les ressources d’abonnement par défaut sont chargées par l’extension Azure Policy.When you first sign in, only the default subscription resources and policies are loaded by the Azure Policy extension. Pour ajouter des abonnements aux ressources et aux stratégies qui s’affichent ou en supprimer, suivez les étapes ci-dessous :To add or remove subscriptions from displaying resources and policies, follow these steps:

  1. Démarrez la commande d’abonnement à partir de la palette de commandes ou du pied de page de la fenêtre.Start the subscription command from the Command Palette or the window footer.

    • Palette de commandes :Command Palette:

      Dans la barre de menus, accédez à Afficher > Palette de commandes, puis entrez Azure Policy : Sélectionner des abonnements.From the menu bar, go to View > Command Palette, and enter Azure Policy: Select Subscriptions.

    • Pied de page de la fenêtreWindow footer

      Dans le pied de page de la fenêtre en bas de l’écran, sélectionnez le segment correspondant à Azure : <votre compte> .In the window footer at the bottom of the screen, select the segment that matches Azure: <your account>.

  2. Utilisez la zone de filtre pour trouver rapidement des abonnements par leur nom.Use the filter box to quickly find subscriptions by name. Ensuite, cochez ou décochez les abonnements pour définir ceux qui seront affichés par l’extension Azure Policy.Then, check or remove the check from each subscription to set the subscriptions shown by the Azure Policy extension. Une fois que vous avez terminé d’ajouter ou de supprimer des abonnements, sélectionnez OK.When done adding or removing subscriptions to display, select OK.

Rechercher et afficher des ressourcesSearch for and view resources

L’extension Azure Policy liste les ressources des abonnements sélectionnés par fournisseur de ressources et par groupe de ressources dans le volet Ressources.The Azure Policy extension lists resources in the selected subscriptions by Resource Provider and by resource group in the Resources pane. L’arborescence comprend les regroupements de ressources suivants au sein de l’abonnement sélectionné ou au niveau de l’abonnement :The treeview includes the following groupings of resources within the selected subscription or at the subscription level:

  • Fournisseurs de ressourcesResource Providers
    • Chacun des fournisseurs de ressources inscrits avec des ressources et les ressources enfants associées qui possèdent des alias de stratégieEach registered Resource Provider with resources and related child resources that have policy aliases
  • Groupes de ressourcesResource Groups
    • Toutes les ressources suivant le groupe de ressources dans lequel elles se trouventAll resources by the resource group they're in

Par défaut, l’extension filtre la partie « Fournisseur de ressources » sur les ressources existantes et les ressources qui possèdent des alias de stratégie.By default, the extension filters the 'Resource Provider' portion by existing resources and resources that have policy aliases. Modifiez ce comportement dans Paramètres > Extensions > Azure Policy pour voir tous les fournisseurs de ressources sans filtrage.Change this behavior in Settings > Extensions > Azure Policy to see all Resource Providers without filtering.

Les clients disposant de centaines ou de milliers de ressources dans un même abonnement préféreront probablement un moyen de trouver leurs ressources avec possibilité de recherche.Customers with hundreds or thousands of resources in a single subscription may prefer a searchable way to locate their resources. L’extension Azure Policy permet de rechercher une ressource spécifique en suivant les étapes suivantes :The Azure Policy extension makes it possible to search for a specific resource with the following steps:

  1. Lancez l’interface de recherche à partir de l’extension Azure Policy ou de la palette de commandes.Start the search interface from the Azure Policy extension or the Command Palette.

    • Extension Azure PolicyAzure Policy extension

      Dans l’extension Azure Policy, placez le curseur sur le panneau Ressources et sélectionnez les points de suspension, puis Rechercher des ressources.From the Azure Policy extension, hover over the Resources panel and select the ellipsis, then select Search Resources.

    • Palette de commandes :Command Palette:

      Dans la barre de menus, accédez à Afficher>Palette de commandes, puis entrez Ressources : Rechercher des ressources.From the menu bar, go to View > Command Palette, and enter Resources: Search Resources.

  2. Si plusieurs abonnements sont sélectionnés pour l’affichage, utilisez le filtre pour sélectionner celui dans lequel la recherche devra être effectuée.If more than one subscription is selected for display, use the filter to select which subscription to search.

  3. Utilisez le filtre pour sélectionner le groupe de ressources dans lequel la recherche devra être effectuée, au sein de l’abonnement choisi.Use the filter to select which resource group to search that is part of the previously chosen subscription.

  4. Utilisez le filtre pour sélectionner la ressource à afficher.Use the filter to select which resource to display. Le filtre fonctionne à la fois pour le nom et le type de ressource.The filter works for both the resource name and the resource type.

Découvrir les alias des propriétés de ressourcesDiscover aliases for resource properties

Lorsqu’une ressource est sélectionnée, que ce soit par le biais de l’interface de recherche ou dans l’arborescence, l’extension Azure Policy ouvre le fichier JSON représentant cette ressource et toutes ses valeurs de propriété Resource Manager.When a resource is selected, whether through the search interface or by selecting it in the treeview, the Azure Policy extension opens the JSON file representing that resource and all it's Resource Manager property values.

Lorsqu’une ressource est ouverte, pointez sur le nom ou la valeur de la propriété Resource Manager pour afficher l’alias Azure Policy s’il en existe un.Once a resource is open, hovering over the Resource Manager property name or value displays the Azure Policy alias if one exists. Dans cet exemple, la ressource a pour type Microsoft.Compute/virtualMachines et le curseur est placé sur la propriété properties.storageProfile.imageReference.offer,In this example, the resource is a Microsoft.Compute/virtualMachines resource type and the properties.storageProfile.imageReference.offer property is hovered over. ce qui affiche les alias correspondants.Hovering shows the matching aliases.

Affichage par pointage des alias de propriété Resource Manager dans l’extension Azure Policy

Rechercher et afficher des stratégies et des affectationsSearch for and view policies and assignments

L’extension Azure Policy liste les types et les affectations de stratégie sous la forme d’une arborescence pour les abonnements à afficher dans le volet Stratégies.The Azure Policy extension lists policy types and policy assignments as a treeview for the subscriptions selected to be displayed in the Policies pane. Les clients disposant de centaines ou de milliers de stratégies ou d’affectations dans un même abonnement préféreront probablement un moyen de trouver leurs stratégies ou leurs affectations avec possibilité de recherche.Customers with hundreds or thousands of policies or assignments in a single subscription may prefer a searchable way to locate their policies or assignments. L’extension Azure Policy permet de rechercher une stratégie ou une affectation spécifique en suivant les étapes suivantes :The Azure Policy extension makes it possible to search for a specific policy or assignment with the following steps:

  1. Lancez l’interface de recherche à partir de l’extension Azure Policy ou de la palette de commandes.Start the search interface from the Azure Policy extension or the Command Palette.

    • Extension Azure PolicyAzure Policy extension

      Dans l’extension Azure Policy, placez le curseur sur le panneau Stratégies et sélectionnez les points de suspension, puis Rechercher des stratégies.From the Azure Policy extension, hover over the Policies panel and select the ellipsis, then select Search Policies.

    • Palette de commandes :Command Palette:

      Dans la barre de menus, accédez à Afficher>Palette de commandes, puis entrez Stratégies : Rechercher des stratégies.From the menu bar, go to View > Command Palette, and enter Policies: Search Policies.

  2. Si plusieurs abonnements sont sélectionnés pour l’affichage, utilisez le filtre pour sélectionner celui dans lequel la recherche devra être effectuée.If more than one subscription is selected for display, use the filter to select which subscription to search.

  3. Utilisez le filtre pour sélectionner l’affectation ou le type de stratégie dans lequel la recherche devra être effectuée, au sein de l’abonnement choisi.Use the filter to select which policy type or assignment to search that is part of the previously chosen subscription.

  4. Utilisez le filtre pour sélectionner la stratégie ou l’affectation à afficher.Use the filter to select which policy or to display. Le filtre fonctionne sur displayName pour la définition ou l’affectation de stratégie.The filter works for displayName for the policy definition or policy assignment.

Lorsqu’une stratégie ou une affectation est sélectionnée, que ce soit par le biais de l’interface de recherche ou dans l’arborescence, l’extension Azure Policy ouvre le fichier JSON représentant la stratégie ou l’affectation et toutes ses valeurs de propriété Resource Manager.When selecting a policy or assignment, whether through the search interface or by selecting it in the treeview, the Azure Policy extension opens the JSON that represents the policy or assignment and all its Resource Manager property values. L’extension peut valider le schéma JSON Azure Policy ouvert.The extension can validate the opened Azure Policy JSON schema.

Se déconnecterSign out

À partir de la barre de menus, accédez à Afficher > Palette de commandes, puis entrez Azure: Se déconnecter.From the menu bar, go to View > Command Palette, and then enter Azure: Sign Out.

Étapes suivantesNext steps