Get-EntraAgentIdentityBlueprint

透過 ID 取得代理身份藍圖。

語法

Default (預設值)

Get-EntraAgentIdentityBlueprint

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

Description

指令Get-EntraAgentIdentityBlueprint本可使用 v1.0 API 及提供的藍圖 ID 從 Microsoft Graph 取得代理身份藍圖。 如果沒有提供 ID,則會使用當前會話中儲存的藍圖 ID,或是提示藍圖。 如果找到藍圖物件,會回傳藍圖物件;找不到則拋出錯誤。

範例

範例 1:依 ID 取得代理人身份藍圖

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

此範例取得具有指定 ID 的代理身份藍圖。

範例 2:從當前會話取得藍圖

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

此範例取得目前會話中使用儲存藍圖 ID 建立的代理身份藍圖。

範例 3:取得帶有錯誤處理功能的代理身份藍圖

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

此範例示範如何利用錯誤處理取得代理身份藍圖,以捕捉藍圖不存在的情況。

參數

-BlueprintId

要取回特工身份藍圖的ID。 如果沒有提供,則使用目前會話中儲存的藍圖 ID,或是針對藍圖提供提示。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

None

輸出

System.Object

回傳包含 id、appId、displayName、createdDateTime 及 requiredResourceAccess 等屬性的 Agent Identity Blueprint 物件。

備註

若找不到包含指定 ID 的代理身份藍圖,指令本會拋出錯誤。

此指令小程式使用 Microsoft Graph v1.0 API 端點(/v1.0/applications/microsoft.graph.agentIdentityBlueprint)。

此指令小程式需要以下 Microsoft Graph 權限:

  • Application.Read.All