Get-EntraBetaAgentIdentity

Modulo:
Microsoft.Entra.Beta.Applications Module v1.3

Ottiene un'identità dell'agente in base al relativo ID.

Sintassi

Default (Impostazione predefinita) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Descrizione

Il Get-EntraBetaAgentIdentity cmdlet recupera un'identità agente da Microsoft Graph usando l'ID agente specificato. Restituisce l'oggetto identity dell'agente se trovato o genera un errore se non viene trovato.

Esempio

Esempio 1: Ottenere un'identità dell'agente in base all'ID

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

In questo esempio viene recuperata l'identità dell'agente con l'ID specificato.

Esempio 2: Ottenere un'identità dell'agente con la gestione degli errori

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

Questo esempio illustra come recuperare un'identità dell'agente con la gestione degli errori per intercettare i casi in cui l'agente non esiste.

Parametri

-AgentId

ID dell'identità dell'agente da recuperare.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object

Restituisce l'oggetto Agent Identity con proprietà che includono ID, displayName, appId e altri dettagli dell'identità dell'agente.

Note

Se l'identità dell'agente con l'ID specificato non viene trovata, il cmdlet genererà un errore.