Get-EntraAgentIdentityBlueprint

Module:
Microsoft.Entra.Applications Module v1.3

Hiermee haalt u een agentidentiteitsblauwdruk op met de id.

Syntax

Default (Standaard) 

Get-EntraAgentIdentityBlueprint

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

Description

Met Get-EntraAgentIdentityBlueprint de cmdlet wordt een Agent Identity Blueprint opgehaald uit Microsoft Graph met behulp van de v1.0-API en de opgegeven Blauwdruk-id. Als er geen id is opgegeven, wordt de opgeslagen blauwdruk-id uit de huidige sessie gebruikt of wordt er om een gevraagd. Retourneert het blauwdrukobject als het is gevonden of genereert een fout als deze niet wordt gevonden.

Voorbeelden

Voorbeeld 1: Een blauwdruk voor agentidentiteit ophalen op id

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

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

Voorbeeld 2: De blauwdruk ophalen uit de huidige sessie

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

In dit voorbeeld wordt de agentidentiteitsblauwdruk opgehaald die in de huidige sessie is gemaakt met behulp van de opgeslagen blauwdruk-id.

Voorbeeld 3: Een agentidentiteitsblauwdruk ophalen met foutafhandeling

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

Parameters

-BlueprintId

De id van de agentidentiteitsblauwdruk die moet worden opgehaald. Als dit niet is opgegeven, gebruikt u de opgeslagen blauwdruk-id uit de huidige sessie of wordt u gevraagd om een blauwdruk-id.

Parametereigenschappen

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

Parametersets

(All)
Position:Named
Verplicht:False
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 object Agent Identity Blueprint met eigenschappen zoals id, appId, displayName, createdDateTime en requiredResourceAccess.

Notities

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

Deze cmdlet maakt gebruik van het Microsoft Graph v1.0 API-eindpunt (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Voor deze cmdlet zijn de volgende Microsoft Graph machtigingen vereist:

  • Application.Read.All