Get-EntraBetaAgentIdentity

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

L’applet Get-EntraBetaAgentIdentity de commande récupère une identité d’agent à partir de Microsoft Graph à l’aide de l’ID d’agent fourni. Retourne l’objet d’identité de l’agent s’il est trouvé ou lève une erreur s’il est introuvable.

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraBetaAgentIdentity -AgentId "27a3cf14-5bdc-4814-bb13-8f1740ca9a4f"

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

Connect-Entra -Scopes 'Application.Read.All'
try {
    $agent = Get-EntraBetaAgentIdentity -AgentId "27a3cf14-5bdc-4814-bb13-8f1740ca9a4f"
    Write-Host "Agent found: $($agent.displayName)"
} catch {
    Write-Host "Agent not found or error occurred: $_"
}

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

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.

Retourne l’objet Agent Identity avec des propriétés, notamment l’ID, displayName, appId et d’autres détails d’identité de l’agent.

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