Get-EntraBetaAgentIdentity

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

Hämtar en agentidentitet med sitt ID.

Syntax

Default (Standard) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Description

Cmdleten Get-EntraBetaAgentIdentity hämtar en agentidentitet från Microsoft Graph med hjälp av det angivna agent-ID:t. Returnerar agentidentitetsobjektet om det hittas eller utlöser ett fel om det inte hittas.

Exempel

Exempel 1: Hämta en agentidentitet efter ID

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

Det här exemplet hämtar agentidentiteten med det angivna ID:t.

Exempel 2: Hämta en agentidentitet med felhantering

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

Det här exemplet visar hur du hämtar en agentidentitet med felhantering för att fånga upp fall där agenten inte finns.

Parametrar

-AgentId

ID:t för agentidentiteten som ska hämtas.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

System.Object

Returnerar agentidentitetsobjektet med egenskaper som ID, displayName, appId och annan agentidentitetsinformation.

Kommentarer

Om agentidentiteten med det angivna ID:t inte hittas utlöser cmdleten ett fel.