Invoke-EntraAgentIdInteractive

モジュール:
Microsoft.Entra.Applications Module v1.3

エージェント ID を作成して構成するための対話型コマンドレット。

構文

Default (既定) 

Invoke-EntraAgentIdInteractive

説明

Invoke-EntraAgentIdInteractive コマンドレットは、エージェント ID とエージェント ユーザーを必要に応じて作成するなど、エージェント ID ブループリントの作成と構成の完全なワークフローを示しています。

この対話型コマンドレットは、主要な決定ポイントでプロンプトを表示する完全なエージェント ID セットアップ プロセスについて説明します。

  1. ブループリントの作成 - オプションのスポンサーを使用してエージェント ID ブループリントを作成する
  2. セキュリティ構成 - API 認証用のクライアント シークレットを追加する
  3. 対話型エージェントのサポート - ユーザーに代わって動作するエージェントのスコープを構成する
  4. エージェント ユーザーの作成 - ユーザーなしでエージェント ID ユーザーを作成できるようにブループリントを構成する
  5. 継承可能なアクセス許可 - エージェント ID がブループリントから継承するアクセス許可を設定する
  6. アクセス許可モデル - 静的 (エージェント 365 に推奨) または動的アクセス許可の選択
  7. 管理者の同意 - ブループリントのアクセス許可に対するテナント管理者の同意を取得する
  8. エージェント ID とユーザーの作成 - 1 つ以上のエージェント ID とエージェント ユーザーを作成する

このコマンドレットは、操作間の状態を維持し、ブループリント ID とその他の必要な値を後続の操作に自動的に渡します。 1 つのセッションで複数のエージェント ID とユーザーを作成できます。

例

例 1: 対話型エージェント ID 構成ワークフローを開始する

Connect-Entra -Scopes 'AgentIdentity.Create.All', 'AgentIdentityBlueprint.UpdateAuthProperties.All', 'AgentIdUser.ReadWrite.All', 'User.ReadBasic.All', 'AgentIdentityBlueprint.AddRemoveCreds.All', 'AgentIdentityBlueprint.ReadWrite.All' -TenantId <tenant ID>
Invoke-EntraAgentIdInteractive

この例では、対話型のエージェント ID 構成ワークフローを開始します。 コマンドレットは、必要なすべての入力を求め、完全なセットアップ プロセスを案内します。

入力

None

出力

None

メモ

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

  • AgentIdentity.Create.All
  • AgentIdentityBlueprint.UpdateAuthProperties.All
  • AgentIdUser.ReadWrite.All
  • User.ReadBasic.All
  • AgentIdentityBlueprint.AddRemoveCreds.All
  • AgentIdentityBlueprint.ReadWrite.All

このコマンドレットを実行するには、上記のアクセス許可を持つアクティブなMicrosoft Graph接続が必要です。 最初に接続するには、 Connect-Entra -Scopes を使用します。 コマンドレットは起動時にアクティブな接続をチェックし、接続されていない場合はエラーをスローします。

コマンドレットは、セッション内の後続の操作に自動的に渡されるモジュール スコープ変数 ( $script:CurrentAgentBlueprintId など) に状態を格納します。