Get-EntraAgentIdentityBlueprint
Obtiene un plano técnico de identidad del agente por su identificador.
Sintaxis
Default (valor predeterminado)
Get-EntraAgentIdentityBlueprint
[-BlueprintId <String>]
[<CommonParameters>]
Description
El Get-EntraAgentIdentityBlueprint cmdlet recupera un plano técnico de identidad del agente de Microsoft Graph mediante la API v1.0 y el identificador de plano técnico proporcionado. Si no se proporciona ningún identificador, usa el identificador de plano técnico almacenado de la sesión actual o solicita uno. Devuelve el objeto de plano técnico si se encuentra o produce un error si no se encuentra.
Ejemplos
Ejemplo 1: Obtención de un plano técnico de identidad del agente por identificador
Connect-Entra -Scopes 'Application.Read.All'
Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
En este ejemplo se recupera el plano técnico de identidad del agente con el identificador especificado.
Ejemplo 2: Obtención del plano técnico de la sesión actual
Connect-Entra -Scopes 'AgentIdentityBlueprint.Create'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
$blueprint = Get-EntraAgentIdentityBlueprint
Write-Host "Blueprint: $($blueprint.displayName)"
En este ejemplo se recupera el plano técnico de identidad del agente que se creó en la sesión actual mediante el identificador de plano técnico almacenado.
Ejemplo 3: Obtención de un plano técnico de identidad del agente con control de errores
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: $_"
}
En este ejemplo se muestra cómo recuperar un plano técnico de identidad del agente con control de errores para detectar casos en los que el plano técnico no existe.
Parámetros
-BlueprintId
Identificador del plano técnico de identidad del agente que se va a recuperar. Si no se proporciona, usa el identificador de plano técnico 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 Agent Identity Blueprint con propiedades como id, appId, displayName, createdDateTime y requiredResourceAccess.
Notas
Si no se encuentra el 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/applications/microsoft.graph.agentIdentityBlueprint).
Este cmdlet requiere los siguientes permisos Microsoft Graph:
- Application.Read.All