New-EntraAgentIdentityBlueprint

Module:
Microsoft.Entra.Applications Module v1.3

Crée un blueprint d’identité d’agent.

Syntaxe

Default (Par défaut) 

New-EntraAgentIdentityBlueprint

    -DisplayName <String>
    [-SponsorUserIds <String[]>]
    [-SponsorGroupIds <String[]>]
    [-OwnerUserIds <String[]>]
    [<CommonParameters>]

Description

L’applet New-EntraAgentIdentityBlueprint de commande crée un blueprint d’identité d’agent à l’aide de l’API Microsoft Graph v1.0. Un blueprint d’identité d’agent sert de modèle pour créer des identités d’agent avec une configuration et des autorisations cohérentes.

Exemples

Exemple 1 : Créer un blueprint avec des sponsors et des propriétaires

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com") -OwnerUserIds @("owner1@contoso.com")

12345678-1234-1234-1234-123456789012

Cet exemple crée un blueprint d’identité d’agent avec le nom d’affichage, les sponsors et les propriétaires spécifiés.

Exemple 2 : Créer un blueprint avec des sponsors d’utilisateurs et de groupes

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "HR Blueprint" -SponsorUserIds @("hr-admin@contoso.com") -SponsorGroupIds @("aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb")

87654321-4321-4321-4321-210987654321

Cet exemple crée un blueprint d’identité d’agent avec des sponsors d’utilisateurs et de groupes.

Exemple 3 : Créer un blueprint avec uniquement des sponsors utilisateur

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "Finance Blueprint" -SponsorUserIds @("finance-admin@contoso.com", "finance-manager@contoso.com")

11112222-3333-4444-5555-666677778888

Cet exemple crée un blueprint d’identité d’agent avec plusieurs sponsors utilisateur.

Paramètres

-DisplayName

Nom complet du blueprint d’identité de l’agent.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OwnerUserIds

Tableau d’ID utilisateur ou UPN à définir en tant que propriétaires.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SponsorGroupIds

Tableau d’ID de groupe à définir en tant que commanditaires.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SponsorUserIds

Tableau d’ID utilisateur ou UPN à définir en tant que sponsors.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

System.String

Retourne l’ID de blueprint d’identité de l’agent.

Notes

Au moins un sponsor (utilisateur ou groupe) doit être spécifié. Les propriétaires sont facultatifs. Si les sponsors ou les propriétaires ne sont pas fournis en tant que paramètres, l’applet de commande invite de manière interactive et suggère l’utilisateur actuel comme valeur par défaut. L’applet de commande valide tous les ID d’utilisateur et de groupe sur le locataire avant de créer le blueprint. L’ID de blueprint est stocké dans une variable au niveau du module à utiliser par d’autres applets de commande associées.

Cette applet de commande utilise le point de terminaison de l’API Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).

Cette applet de commande nécessite les autorisations de Microsoft Graph suivantes :

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All