Get-EntraAgentIdentityBlueprintPrincipal

Módulo:
Microsoft.Entra.Applications Module v1.3

Obtém um Principal de Serviço Blueprint de Identidade de Agente pelo seu ID.

Sintaxe

Default (Predefinição) 

Get-EntraAgentIdentityBlueprintPrincipal

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

Descrição

O Get-EntraAgentIdentityBlueprintPrincipal cmdlet recupera um Agent Identity Blueprint Service Principal do Microsoft Graph usando o Service Principal ID fornecido. Se não for fornecido ID, utiliza o ID principal de serviço armazenado da sessão atual ou os prompts para um. Devolve o objeto principal do serviço se for encontrado, ou lança um erro se não for encontrado.

Exemplos

Exemplo 1: Obtenha um Princípio de Serviço Blueprint por 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

Este exemplo recupera o Agent Identity Blueprint Service Principal com o ID especificado.

Exemplo 2: Obtenha o Princípio do Serviço Blueprint da sessão atual

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

Este exemplo recupera o Agente Identity Blueprint Service Principal que foi criado na sessão atual usando o ID do principal de serviço armazenado.

Exemplo 3: Obtenha um Blueprint Service Principal com tratamento de erros

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: $_"
}

Este exemplo demonstra como recuperar um Agent Identity Blueprint Service Principal com tratamento de erros para detetar casos onde não existe.

Parâmetros

-ServicePrincipalId

O ID do Principal do Serviço Blueprint de Identidade do Agente para recuperar. Se não for fornecido, utiliza o ID do principal de serviço armazenado da sessão atual ou os prompts para um.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Object

Devolve o objeto Agent Identity Blueprint Service Principal com propriedades como id, appId, displayName, createdDateTime e servicePrincipalType.

Notas

Se o Agent Identity Blueprint Service Principal com o ID especificado não for encontrado, o cmdlet gerará um erro.

Este cmdlet utiliza o endpoint da API Microsoft Graph v1.0 (/v1.0/servicePrincipals/graph.agentIdentityBlueprintPrincipal).

Este cmdlet requer as seguintes permissões do Microsoft Graph:

  • Application.Read.All