Get-EntraAgentIdentityBlueprint

Get-EntraAgentIdentityBlueprint

    [-BlueprintId <String>]
    [<CommonParameters>]

Cmdleten Get-EntraAgentIdentityBlueprint hämtar en agentidentitetsritning från Microsoft Graph med hjälp av api:et v1.0 och det angivna skiss-ID:t. Om inget ID anges använder den det lagrade skiss-ID:t från den aktuella sessionen eller frågar efter ett. Returnerar skissobjektet om det hittas eller utlöser ett fel om det inte hittas.

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

Det här exemplet hämtar agentidentitetsritningen med det angivna ID:t.

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
$blueprint = Get-EntraAgentIdentityBlueprint
Write-Host "Blueprint: $($blueprint.displayName)"

Det här exemplet hämtar agentidentitetsritningen som skapades i den aktuella sessionen med hjälp av det lagrade skiss-ID:t.

Connect-Entra -Scopes 'Application.Read.All'
try {
    $blueprint = Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    Write-Host "Blueprint found: $($blueprint.displayName)"
} catch {
    Write-Host "Blueprint not found or error occurred: $_"
}

Det här exemplet visar hur du hämtar en agentidentitetsritning med felhantering för att fånga upp fall där skissen inte finns.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Returnerar agentidentitetsritningsobjektet med egenskaper som ID, appId, displayName, createdDateTime och requiredResourceAccess.

Om agentidentitetsritningen med det angivna ID:t inte hittas utlöser cmdleten ett fel.

Den här cmdleten använder api-slutpunkten Microsoft Graph v1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Den här cmdleten kräver följande Microsoft Graph behörigheter:

• Application.Read.All