Edit

Share via

Add-EntraBetaRedirectURIToAgentIdentityBlueprint

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

Adds a web redirect URI to the current Agent Identity Blueprint.

Syntax

Default (Default) 

Add-EntraBetaRedirectURIToAgentIdentityBlueprint

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

Description

The Add-EntraBetaRedirectURIToAgentIdentityBlueprint cmdlet configures a web redirect URI for the Agent Identity Blueprint application registration. This allows the application to receive authorization callbacks at the specified URI. Uses the stored AgentBlueprintId from the last New-AgentIdentityBlueprint call.

Examples

Example 1: Add default redirect URI using stored blueprint ID

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
New-EntraBetaAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com")
Add-EntraBetaRedirectURIToAgentIdentityBlueprint

This example adds the default redirect URI "http://localhost" to the Agent Identity Blueprint that was just created.

Example 2: Add custom redirect URI

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
Add-EntraBetaRedirectURIToAgentIdentityBlueprint -RedirectUri "http://localhost:3000"

This example adds a custom redirect URI "http://localhost:3000" to the current Agent Identity Blueprint.

Example 3: Add redirect URI with specific blueprint ID

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
Add-EntraBetaRedirectURIToAgentIdentityBlueprint -RedirectUri "https://myapp.com/callback" -AgentBlueprintId "12345678-1234-1234-1234-123456789012"

This example adds a custom redirect URI to a specific Agent Identity Blueprint by providing the blueprint ID.

Parameters

-AgentBlueprintId

The ID of the Agent Identity Blueprint to configure. 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

-RedirectUri

The redirect URI to add to the Agent Identity Blueprint. Defaults to "http://localhost".

Parameter properties

Type:System.String
Default value:http://localhost
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 an object with redirect URI information including the blueprint ID and the list of redirect URIs.

Notes

This cmdlet requires the following Microsoft Graph permission:

  • Application.ReadWrite.All

If the specified redirect URI already exists, the cmdlet will skip adding it and return the existing configuration.