Get-EntraBetaAgentIdentity

Módulo:
Microsoft.Entra.Beta.Applications Module v1.3

Obtém uma Identidade de Agente pelo seu ID.

Sintaxe

Default (Predefinição) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Descrição

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

Exemplos

Exemplo 1: Obtenha uma Identidade de Agente por ID

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

Este exemplo recupera a Identidade do Agente com o ID especificado.

Exemplo 2: Obtenha uma Identidade de Agente com tratamento de erros

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 de Agente com tratamento de erros para detetar casos onde o agente não existe.

Parâmetros

-AgentId

O ID da Identidade do Agente a recuperar.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

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.

Entradas

None

Saídas

System.Object

Devolve o objeto Identidade do Agente com propriedades como id, displayName, appId e outros detalhes de identidade do agente.

Notas

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