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