Get-EntraBetaAgentIdentity

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

Hiermee haalt u een agent-id op met de bijbehorende id.

Syntax

Default (Standaard) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Description

Met Get-EntraBetaAgentIdentity de cmdlet wordt een agent-id opgehaald uit Microsoft Graph met behulp van de opgegeven agent-id. Retourneert het id-object van de agent indien gevonden of genereert een fout als deze niet wordt gevonden.

Voorbeelden

Voorbeeld 1: Een agent-id ophalen op id

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

In dit voorbeeld wordt de agentidentiteit opgehaald met de opgegeven id.

Voorbeeld 2: Een agentidentiteit ophalen met foutafhandeling

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 dit voorbeeld ziet u hoe u een agentidentiteit met foutafhandeling ophaalt om gevallen te ondervangen waarin de agent niet bestaat.

Parameters

-AgentId

De id van de agent-id die moet worden opgehaald.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

System.Object

Retourneert het agentidentiteitsobject met eigenschappen, waaronder id, displayName, appId en andere agentidentiteitsgegevens.

Notities

Als de agentidentiteit met de opgegeven id niet wordt gevonden, genereert de cmdlet een fout.