Naslaginformatie over cli-opdrachten create-instance voor agent 365

Maak agentidentiteit en agentgebruiker en voeg machtigingen toe aan de identiteit en licenties aan de gebruiker. Met de create-instance opdracht worden agentexemplaren gemaakt met identiteiten, licenties en benodigde machtigingen. Gebruik deze opdracht om volledige agentexemplaren in te stellen, waaronder het maken van de agent-id, het toewijzen van de benodigde licenties en het verlenen van machtigingen aan de identiteit.

Met de create-instance opdracht worden deze bewerkingen uitgevoerd:

  1. Identiteit van agent maken - Registreert een service-principal voor de agentidentiteit in Microsoft Entra via de Graph API.
  2. Hiermee maakt u agentgebruiker : hiermee maakt u een agentgebruikersaccount dat is gekoppeld aan de identiteit.
  3. Hiermee wijst u manager en sponsor toe : hiermee stelt u de huidige gebruiker in als manager en sponsor van de gebruiker en identiteit van de agent.
  4. Wijst licenties toe : wijst de vereiste agent 365-licenties toe aan de agentgebruiker.

Minimale rol vereist: globale beheerder

Note

Als u de vereiste agent 365-licenties nog niet hebt om toe te wijzen, kunt u daarna doorgaan met het gebruik create-instance identity en vervolgens gebruiken create-instance licenses om de licenties toe te wijzen wanneer u ze hebt.

Syntax

Hieronder ziet u de syntaxis voor de create-instance opdracht en de optionele subopdrachten.

a365 create-instance [command] [options]

Wanneer u zonder een subopdracht uitvoert create-instance , worden beide stappen op volgorde uitgevoerd: de agentidentiteit en de agentgebruiker worden gemaakt en vervolgens licenties toegewezen.

Options

Gebruik deze opties met de create-instance opdracht of de create-instance identity subopdrachten create-instance licenses .

Option Description
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
-v, --verbose Gedetailleerde uitvoer weergeven
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-?, , -h--help Help- en gebruiksgegevens weergeven

Prerequisites

Voordat u gaat werken create-instance, moet u het volgende doen:

  • De blauwdrukstap voor de installatieagent is voltooid (a365 setup).
  • Uw agent gepubliceerd met behulp van a365 publish.
  • Een geldige a365.config.json werkmap hebben.a365.generated.config.json
  • Aangemeld met een account met globale beheerdersmachtigingen.

voorbeelden van create-instance

Deze voorbeelden laten zien hoe u de create-instance opdracht zonder subopdrachten gebruikt.

Een volledig agentexemplaren maken

Voer create-instance zonder opties uit om een volledig agentexemplaren te maken met behulp van de standaardconfiguratie.

a365 create-instance

Maken met een specifiek configuratiebestand

Gebruik de --config optie om een aangepast configuratiebestandspad op te geven.

a365 create-instance --config path/to/a365.config.json

Een voorbeeld van de wijzigingen bekijken

Gebruik de --dry-run optie om te zien wat create-instance er zou doen zonder wijzigingen aan te brengen.

a365 create-instance --dry-run

create-instance identity

Maak agentidentiteit en agentgebruiker, maar wijs geen licenties toe.

Gebruik deze opdracht om de licenties over te slaan tijdens het maken van een identiteit.

Note

Als u nog geen licenties hebt, gebruikt u deze opdracht zodat u niet bent geblokkeerd. U kunt uitvoeren create-instance licenses wanneer u licenties hebt.

a365 create-instance identity

create-instance licenses

Licenties toevoegen aan een bestaande agentgebruiker.

Gebruik deze opdracht om de licenties te maken wanneer de identiteit al bestaat.

Note

Als u eerder hebt gebruikt create-instance identity , gebruikt u deze opdracht wanneer er licenties beschikbaar zijn.

a365 create-instance licenses

Gebruik deze opdrachten samen om create-instance de volledige levenscyclus van uw agent te beheren.