Get-EntraAgentIdentityBlueprintPrincipal
Obtiene una entidad de servicio de Plano técnico de identidad del agente por su identificador.
Sintaxis
Default (valor predeterminado)
Get-EntraAgentIdentityBlueprintPrincipal
[-ServicePrincipalId <String>]
[<CommonParameters>]
Description
El Get-EntraAgentIdentityBlueprintPrincipal cmdlet recupera una entidad de servicio de Plano técnico de identidad del agente de Microsoft Graph mediante el identificador de entidad de servicio proporcionado. Si no se proporciona ningún identificador, usa el identificador de entidad de servicio almacenado de la sesión actual o solicita uno. Devuelve el objeto de entidad de servicio si se encuentra o produce un error si no se encuentra.
Ejemplos
Ejemplo 1: Obtención de una entidad de servicio de Plano técnico por identificador
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
En este ejemplo se recupera la entidad de servicio Del plano técnico de identidad del agente con el identificador especificado.
Ejemplo 2: Obtención de la entidad de servicio de Blueprint de la sesión actual
Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create'
New-EntraAgentIdentityBlueprintPrincipal
$sp = Get-EntraAgentIdentityBlueprintPrincipal
Write-Host "Service Principal: $($sp.displayName)"
En este ejemplo se recupera la entidad de servicio de Plano técnico de identidad del agente que se creó en la sesión actual mediante el identificador de la entidad de servicio almacenada.
Ejemplo 3: Obtención de una entidad de servicio de Blueprint con control de errores
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: $_"
}
En este ejemplo se muestra cómo recuperar una entidad de servicio de Plano técnico de identidad del agente con control de errores para detectar casos en los que no existe.
Parámetros
-ServicePrincipalId
Identificador de la entidad de servicio de Plano técnico de identidad del agente que se va a recuperar. Si no se proporciona, usa el identificador de entidad de servicio almacenado de la sesión actual o solicita uno.
Propiedades de parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
None
Salidas
System.Object
Devuelve el objeto Service Principal del plano técnico de identidad del agente con propiedades como id, appId, displayName, createdDateTime y servicePrincipalType.
Notas
Si no se encuentra la entidad de servicio del plano técnico de identidad del agente con el identificador especificado, el cmdlet producirá un error.
Este cmdlet usa el punto de conexión de api de Microsoft Graph v1.0 (/v1.0/servicePrincipals/graph.agentIdentityBlueprintPrincipal).
Este cmdlet requiere los siguientes permisos Microsoft Graph:
- Application.Read.All