Get-EntraBetaAgentIdentity

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

Obtiene una identidad del agente por su identificador.

Sintaxis

Default (valor predeterminado) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Description

El Get-EntraBetaAgentIdentity cmdlet recupera una identidad del agente de Microsoft Graph mediante el identificador de agente proporcionado. Devuelve el objeto de identidad del agente si se encuentra o produce un error si no se encuentra.

Ejemplos

Ejemplo 1: Obtención de una identidad del agente por identificador

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

En este ejemplo se recupera la identidad del agente con el identificador especificado.

Ejemplo 2: Obtención de una identidad del agente con control de errores

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

En este ejemplo se muestra cómo recuperar una identidad del agente con control de errores para detectar casos en los que el agente no existe.

Parámetros

-AgentId

Identificador de la identidad del agente que se va a recuperar.

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:True
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 con propiedades como id, displayName, appId y otros detalles de identidad del agente.

Notas

Si no se encuentra la identidad del agente con el identificador especificado, el cmdlet producirá un error.