Get-EntraAgentIdentityBlueprintPrincipal

Modul:
Microsoft.Entra.Applications Module v1.3

Ruft einen Agent Identity Blueprint Service Principal anhand seiner ID ab.

Syntax

Default (Standard) 

Get-EntraAgentIdentityBlueprintPrincipal

    [-ServicePrincipalId <String>]
    [<CommonParameters>]

Beschreibung

Das Get-EntraAgentIdentityBlueprintPrincipal Cmdlet ruft einen Agent Identity Blueprint Service Principal aus Microsoft Graph mithilfe der bereitgestellten Dienstprinzipal-ID ab. Wenn keine ID angegeben wird, verwendet sie die gespeicherte Dienstprinzipal-ID aus der aktuellen Sitzung oder fordert sie zur Eingabe auf. Gibt das Dienstprinzipalobjekt zurück, wenn es gefunden wurde, oder löst einen Fehler aus, wenn er nicht gefunden wurde.

Beispiele

Beispiel 1: Abrufen eines Blueprint-Dienstprinzipals nach ID

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraAgentIdentityBlueprintPrincipal -ServicePrincipalId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

Name                           Value
----                           -----
id                             aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
appId                          bbbbbbbb-1111-2222-3333-cccccccccccc
displayName                    My Blueprint
servicePrincipalType           AgentIdentityBlueprintPrincipal
createdDateTime                2026-04-26T00:00:00Z

In diesem Beispiel wird der Agent Identity Blueprint Service Principal mit der angegebenen ID abgerufen.

Beispiel 2: Abrufen des Blueprint-Dienstprinzipals aus der aktuellen Sitzung

Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create'
New-EntraAgentIdentityBlueprintPrincipal
$sp = Get-EntraAgentIdentityBlueprintPrincipal
Write-Host "Service Principal: $($sp.displayName)"

In diesem Beispiel wird der Agent Identity Blueprint Service Principal abgerufen, der in der aktuellen Sitzung mithilfe der gespeicherten Dienstprinzipal-ID erstellt wurde.

Beispiel 3: Abrufen eines Blueprint-Dienstprinzipals mit Fehlerbehandlung

Connect-Entra -Scopes 'Application.Read.All'
try {
    $sp = Get-EntraAgentIdentityBlueprintPrincipal -ServicePrincipalId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    Write-Host "Service Principal found: $($sp.displayName)"
} catch {
    Write-Host "Service Principal not found or error occurred: $_"
}

In diesem Beispiel wird veranschaulicht, wie Ein Agent Identity Blueprint Service Principal mit Fehlerbehandlung abgerufen wird, um Fälle abzufangen, in denen er nicht vorhanden ist.

Parameter

-ServicePrincipalId

Die ID des abzurufenden Agent Identity Blueprint-Dienstprinzipals. Wenn nicht angegeben, verwendet die gespeicherte Dienstprinzipal-ID aus der aktuellen Sitzung oder Aufforderungen für eine.

Parametereigenschaften

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

Parametersätze

(All)
Position:Named
Obligatorisch:False
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 Blueprint Service Principal -Objekt mit Eigenschaften wie ID, appId, displayName, createdDateTime und servicePrincipalType zurück.

Hinweise

Wenn der Agent Identity Blueprint Service Principal mit der angegebenen ID nicht gefunden wird, löst das Cmdlet einen Fehler aus.

Dieses Cmdlet verwendet den Microsoft Graph v1.0-API-Endpunkt (/v1.0/servicePrincipals/graph.agentIdentityBlueprintPrincipal).

Für dieses Cmdlet sind die folgenden Microsoft Graph Berechtigungen erforderlich:

  • Application.Read.All