Get-EntraAgentIdentityBlueprint

Modulo:
Microsoft.Entra.Applications Module v1.3

Ottiene un progetto di identità agente in base al relativo ID.

Sintassi

Default (Impostazione predefinita) 

Get-EntraAgentIdentityBlueprint

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

Descrizione

Il Get-EntraAgentIdentityBlueprint cmdlet recupera un progetto di identità agente da Microsoft Graph usando l'API v1.0 e l'ID progetto fornito. Se non viene specificato alcun ID, usa l'ID progetto archiviato dalla sessione corrente o ne richiede uno. Restituisce l'oggetto progetto se trovato o genera un errore se non viene trovato.

Esempio

Esempio 1: Ottenere un progetto di identità dell'agente in base all'ID

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

In questo esempio viene recuperato il progetto di identità dell'agente con l'ID specificato.

Esempio 2: Ottenere il progetto dalla sessione corrente

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

In questo esempio viene recuperato il progetto di identità dell'agente creato nella sessione corrente usando l'ID progetto archiviato.

Esempio 3: Ottenere un progetto di identità dell'agente con la gestione degli errori

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

Questo esempio illustra come recuperare un progetto di identità dell'agente con la gestione degli errori per intercettare i casi in cui il progetto non esiste.

Parametri

-BlueprintId

ID del progetto di identità dell'agente da recuperare. Se non specificato, usa l'ID progetto archiviato dalla sessione corrente o ne richiede uno.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object

Restituisce l'oggetto Agent Identity Blueprint con proprietà che includono id, appId, displayName, createdDateTime e requiredResourceAccess.

Note

Se il progetto di identità dell'agente con l'ID specificato non viene trovato, il cmdlet genererà un errore.

Questo cmdlet usa l'endpoint API Microsoft Graph v1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Questo cmdlet richiede le autorizzazioni Microsoft Graph seguenti:

  • Application.Read.All