Quickstart: Een beheergroep maken met JavaScript

Artikel
07/19/2024

Managementgroepen zijn containers die u helpen bij het beheren van toegang, beleid en naleving voor meerdere abonnementen. Maak deze containers om een doeltreffende en efficiënte hiërarchie te maken die kan worden gebruikt met Azure Policy en op rollen gebaseerd toegangsbeheer van Azure. Zie Uw resources indelen met Azure-beheergroepen voor meer informatie over beheergroepen.

Het kan tot vijftien minuten duren voordat de eerste beheergroep die in de map is gemaakt, is voltooid. Er zijn processen die de eerste keer worden uitgevoerd om de service voor beheergroepen in Azure in te stellen voor uw map. U ontvangt een melding wanneer het proces is voltooid. Zie Eerste configuratie van beheergroepen voor meer informatie.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Controleer voordat u begint of ten minste versie 12 van Node.js is geïnstalleerd.
Elke Microsoft Entra ID-gebruiker in de tenant kan een beheergroep maken zonder de schrijfmachtiging voor de beheergroep die aan die gebruiker is toegewezen als hiërarchiebeveiliging niet is ingeschakeld. Deze nieuwe beheergroep wordt een onderliggend element van de hoofdbeheergroep of de standaardbeheergroep en de maker krijgt een roltoewijzing eigenaar. Met de beheergroep-service kan deze functie worden toegewezen, zodat roltoewijzingen niet nodig zijn op hoofdmapniveau. Wanneer de hoofdbeheergroep wordt gemaakt, hebben gebruikers er geen toegang toe. Als u beheergroepen wilt gaan gebruiken, maakt de service het maken van de eerste beheergroepen op het hoofdniveau mogelijk. Zie Hoofdbeheergroep voor elke map voor meer informatie.

Azure Cloud Shell

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

Optie	Voorbeeld/koppeling
Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal.

Azure Cloud Shell gebruiken:

Start Cloud Shell.
Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.
Plak de code of opdracht in de Cloud Shell-sessie door Ctrl+Shift+V in Windows en Linux te selecteren of door Cmd+Shift+V te selecteren in macOS.
Selecteer Enter om de code of opdracht uit te voeren.

Installatie van toepassing

Als u JavaScript wilt inschakelen voor het beheren van beheergroepen, moet de omgeving zijn ingesteld. Deze instelling werkt overal waar JavaScript kan worden gebruikt, met inbegrip van bash in Windows 10.

Stel een nieuw Node.js-project in door de volgende opdracht uit te voeren.
```
npm init -y
```
Voeg een verwijzing toe naar de yargs-module.
```
npm install yargs
```
Voeg een verwijzing toe naar de Azure Resource Graph-module.
```
npm install @azure/arm-managementgroups
```
Voeg een verwijzing toe naar de Azure-verificatiebibliotheek.
```
npm install @azure/identity
```
Notitie

Controleer in package.json @azure/arm-managementgroups versie 2.0.1 of hoger is en @azure/identity of versie 2.0.4 of hoger is.

De beheergroep maken

Maak een nieuw bestand met de naam index. js en voer de volgende code in.

   const argv = require("yargs").argv;
   const { InteractiveBrowserCredential } = require("@azure/identity");
   const { ManagementGroupsAPI } = require("@azure/arm-managementgroups");

   if (argv.groupID && argv.displayName) {
      const createMG = async () => {
         const credentials = new InteractiveBrowserCredential();
         const client = new ManagementGroupsAPI(credentials);
         const result = await client.managementGroups.beginCreateOrUpdateAndWait(
            argv.groupID,
            {
               displayName: argv.displayName
            }
         );
         console.log(result);
      };

   createMG();
}

Voer de volgende opdracht in de terminal in:
```
node index.js --groupID "<NEW_MG_GROUP_ID>" --displayName "<NEW_MG_FRIENDLY_NAME>"
```
Zorg ervoor dat u elk token <> tijdelijke aanduiding vervangt door respectievelijk uw beheergroep-id en beschrijvende naam voor de beheergroep.

Wanneer het script probeert te verifiëren, wordt er een bericht weergegeven dat vergelijkbaar is met het volgende bericht in de terminal:

Als u zich wilt aanmelden, opent u de pagina https://microsoft.com/devicelogin in een webbrowser. Voer de code FGB56WJUGK in om te verifiëren.

Zodra u zich hebt geverifieerd in de browser, wordt het script verder uitgevoerd.

Het resultaat van het maken van de beheergroep wordt uitgevoerd naar de console.

Resources opschonen

Als u de geïnstalleerde bibliotheken uit uw toepassing wilt verwijderen, kunt u dit doen met de volgende opdracht.

npm uninstall @azure/arm-managementgroups @azure/identity yargs

Volgende stappen

In deze quickstart hebt u een beheergroep gemaakt om uw resource-hiërarchie te organiseren. De beheergroep kan abonnementen of andere beheergroepen bevatten.

Ga verder met het volgende voor meer informatie over beheergroepen en het beheren van uw resource-hiërarchie:

Uw resources beheren met beheergroepen

Delen via