Get-EntraAgentIdentityBlueprint

Modul:
Microsoft.Entra.Applications Module v1.3

Ruft einen Agent Identity Blueprint anhand seiner ID ab.

Syntax

Default (Standard) 

Get-EntraAgentIdentityBlueprint

    [-BlueprintId <String>]
    [<CommonParameters>]

Beschreibung

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

Beispiele

Beispiel 1: Abrufen eines Agent Identity Blueprint nach ID

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

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

Beispiel 2: Abrufen des Blueprints aus der aktuellen Sitzung

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
$blueprint = Get-EntraAgentIdentityBlueprint
Write-Host "Blueprint: $($blueprint.displayName)"

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

Beispiel 3: Abrufen eines Agent Identity Blueprint mit Fehlerbehandlung

Connect-Entra -Scopes 'Application.Read.All'
try {
    $blueprint = Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    Write-Host "Blueprint found: $($blueprint.displayName)"
} catch {
    Write-Host "Blueprint not found or error occurred: $_"
}

In diesem Beispiel wird veranschaulicht, wie Sie einen Agent Identity Blueprint mit Fehlerbehandlung abrufen, um Fälle abzufangen, in denen der Blueprint nicht vorhanden ist.

Parameter

-BlueprintId

Die ID des abzurufenden Agent Identity Blueprint. Wenn nicht angegeben, verwendet die gespeicherte Blueprint-ID aus der aktuellen Sitzung oder Eingabeaufforderungen 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 -Objekt mit Eigenschaften wie ID, appId, displayName, createdDateTime und requiredResourceAccess zurück.

Hinweise

Wenn der Agent Identity Blueprint 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/applications/microsoft.graph.agentIdentityBlueprint).

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

  • Application.Read.All