Get-EntraAgentIdentityBlueprint

Module:
Microsoft.Entra.Applications Module v1.3

Obtient un blueprint d’identité d’agent par son ID.

Syntaxe

Default (Par défaut) 

Get-EntraAgentIdentityBlueprint

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

Description

L’applet Get-EntraAgentIdentityBlueprint de commande récupère un blueprint d’identité de l’agent à partir de Microsoft Graph à l’aide de l’API v1.0 et de l’ID de blueprint fourni. Si aucun ID n’est fourni, il utilise l’ID de blueprint stocké à partir de la session active ou vous invite à en fournir un. Retourne l’objet blueprint s’il est trouvé ou lève une erreur s’il n’est pas trouvé.

Exemples

Exemple 1 : Obtenir un blueprint d’identité d’agent par ID

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

Cet exemple récupère le blueprint d’identité de l’agent avec l’ID spécifié.

Exemple 2 : Obtenir le blueprint à partir de la session active

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

Cet exemple récupère le blueprint d’identité de l’agent créé dans la session active à l’aide de l’ID de blueprint stocké.

Exemple 3 : Obtenir un blueprint d’identité d’agent avec gestion des erreurs

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

Cet exemple montre comment récupérer un blueprint d’identité d’agent avec gestion des erreurs pour intercepter les cas où le blueprint n’existe pas.

Paramètres

-BlueprintId

ID du blueprint d’identité de l’agent à récupérer. S’il n’est pas fourni, utilise l’ID de blueprint stocké à partir de la session active ou demande une.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

System.Object

Retourne l’objet Agent Identity Blueprint avec des propriétés telles que l’ID, appId, displayName, createdDateTime et requiredResourceAccess.

Notes

Si le blueprint d’identité de l’agent avec l’ID spécifié est introuvable, l’applet de commande génère une erreur.

Cette applet de commande utilise le point de terminaison de l’API Microsoft Graph v1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Cette applet de commande nécessite les autorisations de Microsoft Graph suivantes :

  • Application.Read.All