Get-EntraAgentIdentityBlueprint

Módulo:
Microsoft.Entra.Applications Module v1.3

Recebe um Plano de Identidade de Agente pelo seu ID.

Sintaxe

Default (Predefinição) 

Get-EntraAgentIdentityBlueprint

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

Descrição

O Get-EntraAgentIdentityBlueprint cmdlet recupera um Blueprint de Identidade de Agente do Microsoft Graph usando a API v1.0 e o ID do Blueprint fornecido. Se não for fornecido um ID, utiliza o ID do blueprint armazenado da sessão atual ou os prompts para um. Devolve o objeto blueprint se for encontrado, ou lança um erro se não for encontrado.

Exemplos

Exemplo 1: Obtenha um Plano de Identidade de Agente por ID

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

Este exemplo recupera o Blueprint de Identidade do Agente com o ID especificado.

Exemplo 2: Obtenha o plano da sessão atual

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

Este exemplo recupera o Blueprint de Identidade do Agente que foi criado na sessão atual usando o ID do blueprint armazenado.

Exemplo 3: Obtenha um Blueprint de Identidade de Agente com tratamento de erros

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

Este exemplo demonstra como recuperar um Blueprint de Identidade de Agente com gestão de erros para detetar casos onde o blueprint não existe.

Parâmetros

-BlueprintId

O ID do Plano de Identidade do Agente para recuperar. Se não for fornecido, usa o ID do blueprint armazenado da sessão atual ou os prompts para um.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Object

Devolve o objeto Blueprint de Identidade do Agente com propriedades como id, appId, displayName, createdDateTime e requiredResourceAccess.

Notas

Se o Blueprint de Identidade do Agente com o ID especificado não for encontrado, o cmdlet dirá um erro.

Este cmdlet utiliza o endpoint da API Microsoft Graph v1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Este cmdlet requer as seguintes permissões do Microsoft Graph:

  • Application.Read.All