Get-EntraAgentIdentityBlueprintPrincipal

Modulo:
Microsoft.Entra.Applications Module v1.3

Ottiene un'entità servizio del progetto di identità dell'agente in base al relativo ID.

Sintassi

Default (Impostazione predefinita) 

Get-EntraAgentIdentityBlueprintPrincipal

    [-ServicePrincipalId <String>]
    [<CommonParameters>]

Descrizione

Il Get-EntraAgentIdentityBlueprintPrincipal cmdlet recupera un'entità servizio del progetto di identità agente da Microsoft Graph usando l'ID entità servizio specificato. Se non viene specificato alcun ID, usa l'ID entità servizio archiviato dalla sessione corrente o ne richiede uno. Restituisce l'oggetto entità servizio se trovato o genera un errore se non viene trovato.

Esempio

Esempio 1: Ottenere un'entità servizio progetto per ID

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

Name                           Value
----                           -----
id                             aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
appId                          bbbbbbbb-1111-2222-3333-cccccccccccc
displayName                    My Blueprint
servicePrincipalType           AgentIdentityBlueprintPrincipal
createdDateTime                2026-04-26T00:00:00Z

In questo esempio viene recuperata l'entità servizio del progetto di identità dell'agente con l'ID specificato.

Esempio 2: Ottenere l'entità servizio blueprint dalla sessione corrente

Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create'
New-EntraAgentIdentityBlueprintPrincipal
$sp = Get-EntraAgentIdentityBlueprintPrincipal
Write-Host "Service Principal: $($sp.displayName)"

In questo esempio viene recuperata l'entità servizio del progetto di identità dell'agente creata nella sessione corrente usando l'ID entità servizio archiviato.

Esempio 3: Ottenere un'entità servizio progetto con la gestione degli errori

Connect-Entra -Scopes 'Application.Read.All'
try {
    $sp = Get-EntraAgentIdentityBlueprintPrincipal -ServicePrincipalId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    Write-Host "Service Principal found: $($sp.displayName)"
} catch {
    Write-Host "Service Principal not found or error occurred: $_"
}

Questo esempio illustra come recuperare un'entità servizio del progetto di identità dell'agente con la gestione degli errori per intercettare i casi in cui non esiste.

Parametri

-ServicePrincipalId

ID dell'entità servizio del progetto di identità dell'agente da recuperare. Se non specificato, usa l'ID entità servizio archiviato dalla sessione corrente o ne richiede uno.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object

Restituisce l'oggetto Agent Identity Blueprint Service Principal con proprietà che includono id, appId, displayName, createdDateTime e servicePrincipalType.

Note

Se l'entità servizio del progetto di identità dell'agente con l'ID specificato non viene trovata, il cmdlet genererà un errore.

Questo cmdlet usa l'endpoint API Microsoft Graph v1.0 (/v1.0/servicePrincipals/graph.agentIdentityBlueprintPrincipal).

Questo cmdlet richiede le autorizzazioni Microsoft Graph seguenti:

  • Application.Read.All