Get-EntraAgentIdentityBlueprint

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

Obtém um Blueprint de Identidade do Agente por sua ID.

Sintaxe

Default (Default) 

Get-EntraAgentIdentityBlueprint

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

Description

O Get-EntraAgentIdentityBlueprint cmdlet recupera um Blueprint de Identidade do Agente de Microsoft Graph usando a API v1.0 e a ID de Blueprint fornecida. Se nenhuma ID for fornecida, ela usará a ID de blueprint armazenada da sessão atual ou solicitará uma. Retorna o objeto blueprint se encontrado ou lança um erro se não for encontrado.

Exemplos

Exemplo 1: Obter um Blueprint de Identidade do 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 a ID especificada.

Exemplo 2: Obter o blueprint 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 a ID de blueprint armazenada.

Exemplo 3: Obter um Blueprint de Identidade do 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 do Agente com tratamento de erro para capturar casos em que o blueprint não existe.

Parâmetros

-BlueprintId

A ID do Blueprint de Identidade do Agente a ser recuperado. Se não for fornecido, usará a ID de blueprint armazenada da sessão atual ou solicitará uma.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Retorna o objeto Agent Identity Blueprint com propriedades incluindo id, appId, displayName, createdDateTime e requiredResourceAccess.

Observações

Se o Blueprint de Identidade do Agente com a ID especificada não for encontrado, o cmdlet gerará um erro.

Esse cmdlet usa o ponto de extremidade da API Microsoft Graph v1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

Esse cmdlet requer as seguintes permissões de Microsoft Graph:

  • Application.Read.All