Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

New-EntraBetaAgentIdentityBlueprintPrincipal

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

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

Related Links

Feedback

Was this page helpful?