Add-EntraRequiredResourceAccessToAgentIdentityBlueprint

Add-EntraRequiredResourceAccessToAgentIdentityBlueprint

    [-AgentBlueprintId <String>]
    [-ResourceAppId <Guid>]
    [-ResourceAccess <Hashtable[]>]
    [-Silent]
    [<CommonParameters>]

Add-EntraRequiredResourceAccessToAgentIdentityBlueprint コマンドレットは、必要なリソース アクセス エントリ (API アクセス許可) をエージェント ID ブループリントに追加します。 これにより、ブループリント アプリケーションに必要な API アクセス許可 (委任されたスコープまたはアプリケーション ロール) が構成されます。 コマンドレットは、既存の必要なリソース アクセス エントリを取得し、既存のアクセス許可を複製せずに新しいアクセス許可をマージし、PATCHes 更新されたリストをアプリケーションに戻します。

対話型モードでは、コマンドレットはリソース アプリケーション ID、アクセス許可の種類 (スコープまたはロール)、およびアクセス許可 GUID を求めます。 リソース サービス プリンシパルが検出可能な場合に、使用可能なアクセス許可を名前で検索できます。 サイレント モードでは、必要なすべてのパラメーターをコマンド ライン引数を使用して指定する必要があります。

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com")
Add-EntraRequiredResourceAccessToAgentIdentityBlueprint

この例では、必要なリソース アクセスを対話形式で追加します。 このコマンドレットは、リソース アプリケーション、アクセス許可の種類、およびアクセス許可 GUID の入力を求めます。

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
$permissions = @(
    @{ id = "e1fe6dd8-ba31-4d61-89e7-88639da4683d"; type = "Scope" },
    @{ id = "df021288-bdef-4463-88db-98f22de89214"; type = "Role" }
)
Add-EntraRequiredResourceAccessToAgentIdentityBlueprint -ResourceAccess $permissions -Silent

この例では、対話型プロンプトを表示せずに、Microsoft Graph委任されたアクセス許可とアプリケーションのアクセス許可を現在のエージェント ID ブループリントに追加します。

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All'
$permissions = @(
    @{ id = "e1fe6dd8-ba31-4d61-89e7-88639da4683d"; type = "Scope" }
)
Add-EntraRequiredResourceAccessToAgentIdentityBlueprint -AgentBlueprintId "12345678-1234-1234-1234-123456789012" -ResourceAppId "00000003-0000-0000-c000-000000000000" -ResourceAccess $permissions -Silent

次の使用例は、特定のMicrosoft Graph委任されたアクセス許可を、指定したエージェント ID ブループリントに追加します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

構成されたリソース アプリケーションごとに 1 つずつ、PSCustomObject エントリの配列を返します。 各エントリには、AgentBlueprintId、ResourceAppId、ResourceAppName、Permissions (Id/Type/DisplayName の配列)、ConfiguredAt、ApiResponse が含まれます。

このコマンドレットでは、Microsoft Graph v1.0 API エンドポイント (/v1.0/applications/{id}) を使用します。

このコマンドレットには、次のMicrosoft Graphアクセス許可が必要です: AgentIdentityBlueprint.ReadWrite.All

コマンドレットは、新しいアクセス許可を上書きするのではなく、既存の必要なリソース アクセス エントリとマージします。 重複するアクセス許可 (同じ ID と種類) はスキップされます。 このコマンドレットには、伝達遅延を処理するための再試行ロジック (10 秒間隔で最大 10 回) が含まれています。