Microsoft Copilot マネージド ランタイム アプリをユーザーとグループと共有する

Copilot マネージド ランタイム アプリは、共有するまで、所有者にプライベートになります。 アプリは、完全に取り消し可能な 2 つの方法で共有できます。特定のユーザーまたはグループと直接共有するか、organization のメンバー全員が利用できる People 内の organization 共有リンクを使用します。 両方の共有方法は、 ms CLI から管理します。

アプリが含まれているディレクトリから共有コマンドを実行します。 各コマンドは、そのアプリに自動的に作用します。

ユーザーがアクセス権を持っている場合、 https://managedapps.cloud.microsoft/でアプリ ポータルからアプリを見つけて起動できます。 エンド ユーザー エクスペリエンスについては、「 Copilot マネージド ランタイム アプリとは」を参照してください。

アクセス レベル

アプリを共有する場合は、次の 2 つのアクセスレベルのいずれかを選択します。

Access 付与される内容
プレイ (既定) アプリを実行します。 このアクセス レベルはエンド ユーザーに適しています。
Edit アプリに投稿します。 プラットフォーム管理の Git の場合、これにはリポジトリへのアクセスが含まれます。 外部 GitHub リポジトリの場合は、GitHub でソース アクセスを個別に付与します。

2 つのレベルは独立しており、一方を許可または取り消しても、他方には影響しません。

GitHub ベースのアプリの場合、コラボレーターには、該当するアプリのアクセス許可と外部リポジトリへのアクセス権の両方が必要です。 リポジトリへのアクセス権の付与と取り消しは、GitHub で個別に行います。アプリ共有コマンドは GitHub のアクセス許可を管理しません。

ユーザーまたはグループにアクセスを許可する

メール アドレスまたはMicrosoft Entraオブジェクト ID のコンマ区切りのリストで ms app share を使用します。

ms app share <principals> [--access play | edit]

たとえば、2 人の同僚にアプリの実行を許可するには、次のようにします。

ms app share alok@contoso.com,maria@contoso.com

コラボレーターに編集アクセス権を付与するには:

ms app share dev-team@contoso.com --access edit

CLI は電子メール アドレスを自動的に検索します。 解決できないエントリがあれば警告として報告し、コマンドは解決したエントリを処理します。 何も解決されない場合、コマンドは失敗します。

アクセス権の取り消し

ms app unshare を使用してアクセスを削除します。

ms app unshare <principals> [--access play | edit]

unshare 指定したアクセス レベルのみを変更します。 たとえば、 edit を取り消しても、ユーザーの play アクセスはそのまま残ります。

ms app unshare dev-team@contoso.com --access edit

要求されたレベルでアクセス権を持たないプリンシパルの削除は no-op であり、失敗しません。

共有リンクは、受信者を 1 人ずつ追加する代わりに配布できる [People in your organization] リンクです。 SharePoint や OneDrive の People in your organization リンクと同様に、これは organization のメンバーのみが使用できる転送可能で取り消し可能なキーです。 メンバーは初めてリンクを開いたときに、まだサインインしていない場合はサインインし、アプリを実行するためのアクセス権が付与されます。 ゲストや organization 外のユーザーはこのリンクを使用できません。 共有リンクは取り消すことができるため、後で個々のユーザーを追跡することなくアクセスを遮断できます。

ms app share link create を使用して、現在のアプリのorganization共有リンクにPeopleを生成します。

ms app share link create

このコマンドは、ショート リンク ID、共有 URL、およびそれが許可するアクセスを返します。 URL を受信者に配布します。

ms app share link list を使用して、現在のアプリのすべてのアクティブな共有リンクを表示します。

ms app share link list

ms app share link revoke を使用して、リンクを引き換えたすべてのユーザーのアクセスを削除し、リンクを削除します。

ms app share link revoke --link-id <id>
  • --link-id <id>: リンクを作成したときに返されるリンク ID。 必須です。
  • --force: 確認プロンプトをスキップします。

ヒント

既知の一連のユーザーに対する直接共有と、アプリをブロードキャストする場合 (チーム チャネルに投稿するなど) 場合は共有リンクを使用しますが、全員のアクセス権を一度に取り消すことができます。