Verwenden der Azure Policy-Erweiterung für Visual Studio CodeUse Azure Policy extension for Visual Studio Code

Gilt für Version 0.0.21 und höher der Azure Policy-Erweiterung.Applies to Azure Policy extension version 0.0.21 and newer

Erfahren Sie, wie Sie die Azure Policy-Erweiterung für Visual Studio Code verwenden, um nach Aliasen zu suchen und Ressourcen und Richtlinien zu überprüfen.Learn how to use the Azure Policy extension for Visual Studio Code to look up aliases and review resources and policies. Zunächst wird beschrieben, wie Sie die Azure Policy-Erweiterung in Visual Studio Code installieren.First, we'll describe how to install the Azure Policy extension in Visual Studio Code. Anschließend erfahren Sie, wie Sie Aliase suchen.Then we'll walk through how to look up aliases.

Die Azure Policy-Erweiterung für Visual Studio Code kann auf allen Plattformen installiert werden, die von Visual Studio Code unterstützt werden.Azure Policy extension for Visual Studio Code can be installed on all platforms that are supported by Visual Studio Code. Diese Unterstützung umfasst Windows, Linux und macOS.This support includes Windows, Linux, and macOS.

Hinweis

Lokal an Richtlinien vorgenommene Änderungen, die in der Azure Policy-Erweiterung für Visual Studio Code angezeigt werden, werden nicht mit Azure synchronisiert.Changes made locally to policies viewed in the Azure Policy extension for Visual Studio Code aren't synced to Azure.

VoraussetzungenPrerequisites

Für die Schritte in diesem Artikel ist Folgendes erforderlich:The following items are required for completing the steps in this article:

Installieren der Azure Policy-ErweiterungInstall Azure Policy extension

Wenn die Voraussetzungen erfüllt sind, können Sie die Azure Policy-Erweiterung für Visual Studio Code mithilfe der folgenden Schritte installieren:After you meet the prerequisites, you can install Azure Policy extension for Visual Studio Code by following these steps:

  1. Öffnen Sie Visual Studio Code.Open Visual Studio Code.

  2. Navigieren Sie auf der Menüleiste zu Ansicht > Erweiterungen.From the menu bar, go to View > Extensions.

  3. Geben Sie im Suchfeld Azure Policy ein.In the search box, enter Azure Policy.

  4. Wählen Sie in den Suchergebnissen Azure Policy aus, und wählen Sie dann Installieren.Select Azure Policy from the search results, and then select Install.

  5. Wählen Sie bei Bedarf Erneut laden aus.Select Reload when necessary.

Einrichten der Azure-UmgebungSet the Azure environment

Führen Sie für Benutzer der nationalen Cloud die folgenden Schritte aus, um zunächst die Azure-Umgebung festzulegen:For a national cloud user, follow these steps to set the Azure environment first:

  1. Wählen Sie Datei > Einstellungen > Einstellungen aus.Select File\Preferences\Settings.

  2. Suchen Sie nach folgender Zeichenfolge: Azure: Cloud.Search on the following string: Azure: Cloud

  3. Wählen Sie in der Liste die nationale Cloud aus:Select the nation cloud from the list:

    Festlegen der Anmeldung bei der Azure-Standardcloud für Visual Studio Code

Verbinden mit einem Azure-KontoConnect to an Azure account

Zum Auswerten von Ressourcen und Suchen nach Aliasen müssen Sie eine Verbindung mit Ihrem Azure-Konto herstellen.To evaluate resources and lookup aliases, you must connect to your Azure account. Führen Sie die folgenden Schritte aus, um eine Verbindung mit Azure aus Visual Studio Code herzustellen:Follow these steps to connect to Azure from Visual Studio Code:

  1. Melden Sie sich über die Azure Policy-Erweiterung oder die Befehlspalette bei Azure an.Sign in to Azure from the Azure Policy extension or the Command Palette.

    • Azure Policy-ErweiterungAzure Policy extension

      Wählen Sie in der Azure Policy-Erweiterung die Option Bei Azure anmelden aus.From the Azure Policy extension, select Sign in to Azure.

      Azure Cloud-Anmeldung für Visual Studio Code über die Azure Policy-Erweiterung

    • BefehlspaletteCommand Palette

      Navigieren Sie auf der Menüleiste zu Ansicht > Befehlspalette, und geben Sie Azure: Anmelden ein.From the menu bar, go to View > Command Palette, and enter Azure: Sign In.

      Azure Cloud-Anmeldung für Visual Studio Code über die Befehlspalette

  2. Befolgen Sie die Anleitung für die Anmeldung, um sich bei Azure anzumelden.Follow the sign in instructions to sign in to Azure. Nach dem Herstellen der Verbindung wird Ihr Azure-Kontoname unten im Visual Studio Code-Fenster in der Statusleiste angezeigt.After you're connected, your Azure account name is shown on the status bar at the bottom of the Visual Studio Code window.

Auswählen von AbonnementsSelect subscriptions

Bei der ersten Anmeldung werden nur die Ressourcen und Richtlinien des Standardabonnements von der Azure Policy-Erweiterung geladen.When you first sign in, only the default subscription resources and policies are loaded by the Azure Policy extension. Gehen Sie folgendermaßen vor, um Abonnements für die Anzeige von Ressourcen und Richtlinien hinzuzufügen oder zu entfernen:To add or remove subscriptions from displaying resources and policies, follow these steps:

  1. Starten Sie den Abonnementbefehl über die Befehlspalette oder die Fensterfußzeile.Start the subscription command from the Command Palette or the window footer.

    • Befehlspalette:Command Palette:

      Navigieren Sie auf der Menüleiste zu Ansicht > Befehlspalette, und geben Sie Azure Policy: Abonnements auswählen ein.From the menu bar, go to View > Command Palette, and enter Azure Policy: Select Subscriptions.

    • FensterfußzeileWindow footer

      Wählen Sie in der Fensterfußzeile am unteren Bildschirmrand das Segment aus, das Azure: <Ihr Konto> entspricht.In the window footer at the bottom of the screen, select the segment that matches Azure: <your account>.

  2. Verwenden Sie das Filterfeld, um Abonnements schnell nach Namen zu finden.Use the filter box to quickly find subscriptions by name. Dann aktivieren bzw. deaktivieren Sie die einzelnen Abonnements, um die von der Azure Policy-Erweiterung angezeigten Abonnements festzulegen.Then, check or remove the check from each subscription to set the subscriptions shown by the Azure Policy extension. Nachdem Sie Abonnements für die Anzeige hinzugefügt oder entfernt haben, klicken Sie auf OK.When done adding or removing subscriptions to display, select OK.

Suchen nach und Anzeigen von RessourcenSearch for and view resources

Die Azure Policy-Erweiterung listet Ressourcen in den ausgewählten Abonnements nach Ressourcenanbieter und nach Ressourcengruppe im Bereich Ressourcen auf.The Azure Policy extension lists resources in the selected subscriptions by Resource Provider and by resource group in the Resources pane. Die Strukturansicht enthält die folgenden Gruppierungen von Ressourcen innerhalb des ausgewählten Abonnements oder auf Abonnementebene:The treeview includes the following groupings of resources within the selected subscription or at the subscription level:

  • RessourcenanbieterResource Providers
    • Jeder registrierte Ressourcenanbieter mit Ressourcen und zugehörigen untergeordneten Ressourcen, die Richtlinienaliase aufweisenEach registered Resource Provider with resources and related child resources that have policy aliases
  • RessourcengruppenResource Groups
    • Alle Ressourcen nach der Ressourcengruppe, in der sie enthalten sindAll resources by the resource group they're in

Standardmäßig filtert die Erweiterung den Abschnitt „Ressourcenanbieter“ nach vorhandenen Ressourcen und Ressourcen mit Richtlinienaliasen.By default, the extension filters the 'Resource Provider' portion by existing resources and resources that have policy aliases. Ändern Sie dieses Verhalten unter Einstellungen > Erweiterungen > Azure Policy, um alle Ressourcenanbieter ohne Filter anzuzeigen.Change this behavior in Settings > Extensions > Azure Policy to see all Resource Providers without filtering.

Kunden mit Hunderten oder Tausenden von Ressourcen in einem einzelnen Abonnement bevorzugen möglicherweise eine Suchmethode zum Auffinden ihrer Ressourcen.Customers with hundreds or thousands of resources in a single subscription may prefer a searchable way to locate their resources. Die Azure Policy-Erweiterung ermöglicht die Suche nach einer bestimmten Ressource mit den folgenden Schritten:The Azure Policy extension makes it possible to search for a specific resource with the following steps:

  1. Starten Sie die Suchschnittstelle über die Azure Policy-Erweiterung oder die Befehlspalette.Start the search interface from the Azure Policy extension or the Command Palette.

    • Azure Policy-ErweiterungAzure Policy extension

      Zeigen Sie in der Azure Policy-Erweiterung auf den Bereich Ressourcen, und wählen Sie die Auslassungspunkte und dann Ressourcen suchen aus.From the Azure Policy extension, hover over the Resources panel and select the ellipsis, then select Search Resources.

    • Befehlspalette:Command Palette:

      Navigieren Sie auf der Menüleiste zu Ansicht > Befehlspalette, und geben Sie Ressourcen: Ressourcen suchen ein.From the menu bar, go to View > Command Palette, and enter Resources: Search Resources.

  2. Wenn mehr als ein Abonnement für die Anzeige ausgewählt ist, wählen Sie mit dem Filter das zu durchsuchende Abonnement aus.If more than one subscription is selected for display, use the filter to select which subscription to search.

  3. Wählen Sie mit dem Filter aus, welche Ressourcengruppe durchsucht werden soll, die Teil des zuvor ausgewählten Abonnements ist.Use the filter to select which resource group to search that is part of the previously chosen subscription.

  4. Wählen Sie mit dem Filter aus, welche Ressource angezeigt werden soll.Use the filter to select which resource to display. Der Filter kann sowohl für den Ressourcennamen als auch den Ressourcentyp verwendet werden.The filter works for both the resource name and the resource type.

Ermitteln von Aliasen für RessourceneigenschaftenDiscover aliases for resource properties

Bei Auswahl einer Ressource (unabhängig davon, ob über die Suchschnittstelle oder durch Auswahl in der Strukturansicht) öffnet die Azure Policy-Erweiterung die JSON-Datei, die diese Ressource und alle zugehörigen Resource Manager-Eigenschaftswerte darstellt.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.

Sobald eine Ressource geöffnet ist, wird beim Zeigen auf den Namen oder den Wert der Resource Manager-Eigenschaft der Azure Policy-Alias angezeigt (sofern vorhanden).Once a resource is open, hovering over the Resource Manager property name or value displays the Azure Policy alias if one exists. In diesem Beispiel ist die Ressource vom Typ Microsoft.Compute/virtualMachines, und es wird auf die Eigenschaft properties.storageProfile.imageReference.offer gezeigt.In this example, the resource is a Microsoft.Compute/virtualMachines resource type and the properties.storageProfile.imageReference.offer property is hovered over. Beim Zeigen werden die entsprechenden Aliase eingeblendet.Hovering shows the matching aliases.

Zeigen in der Azure Policy-Erweiterung zum Einblenden des Resource Manager-Eigenschaftenalias

Suchen nach und Anzeigen von Richtlinien und ZuweisungenSearch for and view policies and assignments

Die Azure Policy-Erweiterung listet Richtlinientypen und Richtlinienzuweisungen in Form einer Strukturansicht für die Abonnements auf, die zur Anzeige im Bereich Richtlinien ausgewählt wurden.The Azure Policy extension lists policy types and policy assignments as a treeview for the subscriptions selected to be displayed in the Policies pane. Kunden mit Hunderten oder Tausenden von Richtlinien oder Zuweisungen in einem einzelnen Abonnement bevorzugen möglicherweise eine Suchmethode zum Auffinden ihrer Richtlinien oder Zuweisungen.Customers with hundreds or thousands of policies or assignments in a single subscription may prefer a searchable way to locate their policies or assignments. Die Azure Policy-Erweiterung ermöglicht die Suche nach einer bestimmten Richtlinie oder Zuweisung mit den folgenden Schritten:The Azure Policy extension makes it possible to search for a specific policy or assignment with the following steps:

  1. Starten Sie die Suchschnittstelle über die Azure Policy-Erweiterung oder die Befehlspalette.Start the search interface from the Azure Policy extension or the Command Palette.

    • Azure Policy-ErweiterungAzure Policy extension

      Zeigen Sie in der Azure Policy-Erweiterung auf den Bereich Richtlinien, und wählen Sie die Auslassungspunkte und dann Richtlinien suchen aus.From the Azure Policy extension, hover over the Policies panel and select the ellipsis, then select Search Policies.

    • Befehlspalette:Command Palette:

      Navigieren Sie auf der Menüleiste zu Ansicht > Befehlspalette, und geben Sie Richtlinien: Richtlinien suchen ein.From the menu bar, go to View > Command Palette, and enter Policies: Search Policies.

  2. Wenn mehr als ein Abonnement für die Anzeige ausgewählt ist, wählen Sie mit dem Filter das zu durchsuchende Abonnement aus.If more than one subscription is selected for display, use the filter to select which subscription to search.

  3. Wählen Sie mit dem Filter aus, welcher Richtlinientyp oder welche Richtlinienzuweisung durchsucht werden soll, die Teil des zuvor ausgewählten Abonnements ist.Use the filter to select which policy type or assignment to search that is part of the previously chosen subscription.

  4. Wählen Sie mit dem Filter aus, welche Richtlinie angezeigt werden soll.Use the filter to select which policy or to display. Der Filter kann für displayName für die Richtliniendefinition oder die Richtlinienzuweisung verwendet werden.The filter works for displayName for the policy definition or policy assignment.

Bei Auswahl einer Richtlinie oder Zuweisung (unabhängig davon, ob über die Suchschnittstelle oder durch Auswahl in der Strukturansicht) öffnet die Azure Policy-Erweiterung die JSON-Datei, die diese Richtlinie oder Zuweisung und alle zugehörigen Resource Manager-Eigenschaftswerte darstellt.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. Die Erweiterung kann das geöffnete Azure Policy-JSON-Schema überprüfen.The extension can validate the opened Azure Policy JSON schema.

AbmeldenSign out

Navigieren Sie auf der Menüleiste zu Ansicht > Befehlspalette, und geben Sie dann Azure: Abmelden ein.From the menu bar, go to View > Command Palette, and then enter Azure: Sign Out.

Nächste SchritteNext steps