Get-EntraBetaAgentIdentity

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

Ruft eine Agent-Identität anhand ihrer ID ab.

Syntax

Default (Standard) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Beschreibung

Das Get-EntraBetaAgentIdentity Cmdlet ruft eine Agent-Identität aus Microsoft Graph mithilfe der bereitgestellten Agent-ID ab. Gibt das Agent-Identitätsobjekt zurück, wenn es gefunden wurde, oder löst einen Fehler aus, wenn er nicht gefunden wurde.

Beispiele

Beispiel 1: Abrufen einer Agent-Identität nach ID

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

In diesem Beispiel wird die Agent-Identität mit der angegebenen ID abgerufen.

Beispiel 2: Abrufen einer Agentidentität mit Fehlerbehandlung

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

In diesem Beispiel wird veranschaulicht, wie Sie eine Agent-Identität mit Fehlerbehandlung abrufen, um Fälle abzufangen, in denen der Agent nicht vorhanden ist.

Parameter

-AgentId

Die ID der abzurufenden Agent-Identität.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object

Gibt das Agent Identity -Objekt mit Eigenschaften wie ID, displayName, appId und anderen Agent-Identitätsdetails zurück.

Hinweise

Wenn die Agent-Identität mit der angegebenen ID nicht gefunden wird, löst das Cmdlet einen Fehler aus.