Get-EntraBetaAgentIdentity

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

O Get-EntraBetaAgentIdentity cmdlet recupera uma identidade de agente de Microsoft Graph usando a ID do agente fornecida. Retorna o objeto de identidade do agente se encontrado ou lança um erro se não for encontrado.

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

Este exemplo recupera a Identidade do Agente com a ID especificada.

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

Este exemplo demonstra como recuperar uma Identidade do Agente com tratamento de erros para capturar casos em que o agente não existe.

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.

Retorna o objeto Agent Identity com propriedades incluindo id, displayName, appId e outros detalhes de identidade do agente.

Se a Identidade do Agente com a ID especificada não for encontrada, o cmdlet gerará um erro.