Edit

Share via

New-EntraBetaAgentIdentityBlueprintPrincipal

Module:
Microsoft.Entra.Beta.Applications Module v1.2

Creates a service principal for the Agent Identity Blueprint.

Syntax

Default (Default) 

New-EntraBetaAgentIdentityBlueprintPrincipal

    [-AgentBlueprintId <String>]
    [<CommonParameters>]

Description

The New-EntraBetaAgentIdentityBlueprintPrincipal cmdlet creates a service principal for the current Agent Identity Blueprint using the specialized graph.agentIdentityBlueprintPrincipal endpoint. Uses the stored AgentBlueprintId from the last New-EntraBetaAgentIdentityBlueprint call.

Examples

Example 1: Create service principal using stored blueprint ID

Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create', 'AgentIdentityBlueprint.ReadWrite.All'
New-EntraBetaAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com")
New-EntraBetaAgentIdentityBlueprintPrincipal

This example creates a service principal for the Agent Identity Blueprint that was just created. The cmdlet uses the stored blueprint ID from the last blueprint creation.

Example 2: Create service principal with specific blueprint ID

Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create', 'AgentIdentityBlueprint.ReadWrite.All'
New-EntraBetaAgentIdentityBlueprintPrincipal -AgentBlueprintId "021fe0d0-d128-4769-950c-fcfbf7b87def"

This example creates a service principal for a specific Agent Identity Blueprint by providing the blueprint ID.

Parameters

-AgentBlueprintId

The Application ID (AppId) of the Agent Identity Blueprint to create the service principal for. If not provided, uses the stored ID from the last blueprint creation.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

System.Object

Returns the service principal response object from Microsoft Graph with properties including id, appId, and displayName.

Notes

This cmdlet requires an Agent Identity Blueprint to be created first. The cmdlet stores the service principal ID in a module-level variable for use by other related cmdlets.

This cmdlet requires the following Microsoft Graph permissions:

  • AgentIdentityBlueprintPrincipal.Create
  • Application.ReadWrite.All