Copilot プロンプト ギャラリーでは、ユーザーが作成したプロンプトを保存または共有できます。これには、自分がメンバーである特定のチーム (Microsoft Teams) とのプロンプトの共有が含まれます。 ユーザーは、他のユーザーが作成したプロンプトを好きにすることもできます。 管理者は、Windows PowerShellを使用して、Copilot プロンプト ギャラリーの次のいずれかの種類のプロンプトに関するデータをファイルにエクスポートできます。
- 特定のユーザーの保存、いいね、共有のプロンプト。
- プロンプトは、特定のチームと共有されます。
注:
PowerShell スクリプトを実行してデータをエクスポートするユーザー アカウントには、グローバル 管理 ロールを割り当てる必要があります。
Windows PowerShell環境を構成する
ユーザーがCopilot プロンプト ギャラリーで保存、いいね、共有したプロンプトをエクスポートする前に、次の手順を実行して PowerShell 環境を構成する必要があります。
CopilotLabDSR PowerShell スクリプトをダウンロードする
開始するには、 CopilotLabDSR PowerShell スクリプトをダウンロードする必要があります。
エクスプローラーで、CopilotLabDSR.psm1 ファイルを保存した場所に移動します。
CopilotLabDSR.psm1 ファイルを右クリックし、[プロパティ] を選択 します。
[ 全般 ] タブで、[ ブロック解除 ] チェック ボックスをオンにし、[OK] を選択 します。
既定では、インターネットからダウンロードしたスクリプトの実行が許可されていないため、ファイルのブロックを解除する必要があります。
MSAL.PS モジュールをインストールする
- PowerShell で次のコマンドを実行して、MSAL.PS モジュールがインストールされているかどうかを確認します。
Get-Module -ListAvailable MSAL.PS - モジュールがインストールされていない場合は、PowerShell で次のコマンドを実行してモジュールをインストールします。
Install-Module -Name MSAL.PS -Scope CurrentUser
CopilotLabDSR モジュールを読み込む
PowerShell で次のコマンドを実行して、このセッションに対してのみインターネットからダウンロードされたスクリプトを実行できるようにします。 "Y" と入力して確認を求めるメッセージが表示される場合があります。
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process次のコマンドを実行して、使用可能なすべてのコマンドレットを使用してモジュールをインポートします。
Import-module "<location where you saved the CopilotLabDSR.psm1 file>"たとえば、ファイルが C:\AdminScripts に保存されている場合は、次のように入力します。
Import-module "C:\AdminScripts\CopilotLabDSR.psm1"
特定のユーザーの保存、いいね、共有のプロンプトをエクスポートする
- Windows PowerShellから、
Export- PromptsUserContentコマンドレットを使用して、特定のユーザーの保存、いいね、または共有のプロンプトをCopilot プロンプト ギャラリーからエクスポートします。
Export-PromptsUserContent -UserAadIdOrPrincipalName <Entra ID or UPN of user> -ExportDirectory <output location> -PromptType <type of prompt>
| パラメーター | 説明 |
|---|---|
| UserAadIdOrPrincipalName | コンテンツをエクスポートするユーザーのMicrosoft Entra IDまたはユーザー プリンシパル名 (UPN) を使用します。 |
| ExportDirectory | 出力ファイルを保存する場所です。 フォルダーは既に存在しているはずです。 指定しない場合、エクスポート ファイルは現在のフォルダーに保存されます。 |
| PromptType | ユーザーが保存したプロンプトをエクスポートするには、"saved" を指定します。 "shared" を指定して、プロンプトへの共有可能なリンクが生成されたプロンプトをエクスポートします。 ユーザーが気に入ったプロンプトをエクスポートするには、"いいね" を指定します。 |
たとえば、次の例では、UPN を使用して Reed Smiths の保存されたプロンプトを Copilot プロンプト ギャラリーにエクスポートし、エクスポート ファイルを C:\PromptsExportReedSmith の場所にダウンロードします。
Export- PromptsUserContent -UserAadIdOrPrincipalName reedsmith@contoso.com -ExportDirectory C:\PromptsExportReedSmith -PromptType saved
- 認証を求められたら、エクスポートするユーザーとしてではなく、グローバル 管理 ロールが割り当てられているアカウントでサインインします。
- PowerShell コマンドレットが正常に実行されたら、エクスポート先に移動してエクスポートされたファイルを表示します。
特定のチームと共有するプロンプトをエクスポートする
- Windows PowerShellから、
Export-PromptsGroupContentコマンドレットを使用して、Copilot プロンプト ギャラリーの特定のチームに発行されたプロンプトをエクスポートします。
Export-PromptsGroupContent -M365TeamsGroupId <team ID> -ExportDirectory <output location>
| パラメーター | 説明 |
|---|---|
| M365TeamsGroupId | プロンプトが共有されたチームの ID。 |
| ExportDirectory | 出力ファイルを保存する場所です。 フォルダーは既に存在しているはずです。 指定しない場合、エクスポート ファイルは現在のフォルダーに保存されます。 |
たとえば、次の例では、Copilot プロンプト ギャラリーで共有されているプロンプトを "d0efcad2-6744-0de6-0624-ea467d4293af" の ID でチームにエクスポートし、エクスポート ファイルを C:\PromptsExportReedSmith の場所にダウンロードします。
Export- PromptsGroupContent -M365TeamsGroupId d0efcad2-6744-0de6-0624-ea467d4293af -ExportDirectory C:\PromptsExportReedSmith
ヒント
チームの ID を見つけるには、Teams 管理センターの Teams>Manage Teams に移動します。
- 認証を求められたら、グローバル 管理 ロールが割り当てられているアカウントでサインインします。
- PowerShell コマンドレットが正常に実行されたら、エクスポート先に移動してエクスポートされたファイルを表示します。
エクスポート ファイルに含まれるプロパティとその説明
PowerShell コマンドレットを実行してユーザーのデータをCopilot プロンプト ギャラリーからエクスポートすると、ダウンロード場所フォルダーに 1 つのファイルが表示されます。 次のセクションの情報を使用すると、受信したファイルに表示されるプロパティを理解するのに役立ちます。
特定のユーザーの保存、いいね、共有のプロンプトのファイルをエクスポートする
ファイル名の前に "User" が付き、ユーザーのMicrosoft Entra IDの後にエクスポートに使用されるプロンプトの種類が続きます。 ファイルには、次の表に示すプロパティがあります。
| プロパティ | 説明 |
|---|---|
| プロンプト | 保存または共有されたユーザーの配列によって、情報が求められます。 |
| Prompt.Title | プロンプトの保存または共有中にユーザーが指定したプロンプトのタイトル。 |
| Prompt.PromptText | テキストの入力を求める |
| Prompt.Products | ユーザーがプロンプトを保存または共有した製品を含むリスト。 |
| Prompt.IsFavorite | ユーザーがプロンプトを保存または好きであることを示すブール値 (true または false)。 |
| Prompt.UserActivity.Favorite.IsFavorite | ユーザーがプロンプトを保存または好きであることを示すブール値 (true または false)。 |
| Prompt.UserActivity.Favorite.ActivityDateTimeInUtc | ユーザーがプロンプトを保存または気に入った時刻。 |
| Prompt.CreatedTime | ユーザーがプロンプトを保存した時刻。 |
| Prompt.SharedTime | ユーザーがプロンプトを共有した時刻 |
| Prompt.HydratedEntities | 型とエンティティ情報を含むエンティティの一覧。 |
| Prompt.HydratedEntities.Type | 現在、People、ファイル、会議エンティティの種類がサポートされています。 |
| Prompt.HydratedEntities.Entity | エンティティの種類に基づくエンティティ情報。 |
| Prompt.HydratedEntities.Entity.Id | 一意のエンティティ ID。 |
| Prompt.HydratedEntities.Entity.DisplayName | Person エンティティの表示名。 |
| Prompt.HydratedEntities.Entity.EmailAddresses | 個人エンティティの電子メール アドレスの一覧。 |
| Prompt.HydratedEntities.Entity.ReferenceId | インストルメンテーション マッピングの一意の ID。 |
| Prompt.HydratedEntities.Entity.FileName | ファイル エンティティの名前。 |
| Prompt.HydratedEntities.Entity.AccessUrl | ファイル エンティティのアクセス URL。 |
| Prompt.HydratedEntities.Entity.SpoId | ファイル エンティティの SharePoint ドキュメント識別子。 |
| Prompt.HydratedEntities.Entity.OriginalId | イベント エンティティの会議 ID。 |
| Prompt.HydratedEntities.Entity.Subject | イベント エンティティの件名。 |
| Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl | イベント エンティティの URL。 |
| Prompt.HydratedEntities.Entity.Start | イベント エンティティの開始時刻。 |
| Prompt.HydratedEntities.Entity.End | イベント エンティティの終了時刻。 |
| Prompt.HydratedEntities.Entity.OrganizerName | 開催者 イベント エンティティの名前。 |
| Prompt.HydratedEntities.Entity.OrganizerAddress | 開催者 イベント エンティティのアドレス。 |
| Prompt.HydratedEntities.Entity.Attendees | イベント エンティティの出席者の一覧。 |
特定のチームと共有するプロンプトのファイルをエクスポートする
ファイル名の先頭に "Group" とチームの ID が付いています。 ファイルには、次の表に示すプロパティがあります。
| プロパティ | 説明 |
|---|---|
| プロンプト | 保存または共有されたユーザーの配列によって、情報が求められます。 |
| Prompt.Title | プロンプトの保存または共有中にユーザーが指定したプロンプトのタイトル。 |
| Prompt.PromptText | テキストの入力を求める |
| Prompt.Products | ユーザーがプロンプトを保存または共有した製品を含むリスト。 |
| Prompt.PublishedTime | プロンプトがチームに発行された時刻。 |
| Prompt.PublishedBy | プロンプトをチームに公開したユーザーの UPN。 |
| Prompt.HydratedEntities | 型とエンティティ情報を含むエンティティの一覧。 |
| Prompt.HydratedEntities.Type | 現在、People、ファイル、会議エンティティの種類がサポートされています。 |
| Prompt.HydratedEntities.Entity | エンティティの種類に基づくエンティティ情報。 |
| Prompt.HydratedEntities.Entity.Id | 一意のエンティティ ID。 |
| Prompt.HydratedEntities.Entity.DisplayName | Person エンティティの表示名。 |
| Prompt.HydratedEntities.Entity.EmailAddresses | 個人エンティティの電子メール アドレスの一覧。 |
| Prompt.HydratedEntities.Entity.ReferenceId | インストルメンテーション マッピングの一意の ID。 |
| Prompt.HydratedEntities.Entity.FileName | ファイル エンティティの名前。 |
| Prompt.HydratedEntities.Entity.AccessUrl | ファイル エンティティのアクセス URL。 |
| Prompt.HydratedEntities.Entity.SpoId | ファイル エンティティの SharePoint ドキュメント識別子。 |
| Prompt.HydratedEntities.Entity.OriginalId | イベント エンティティの会議 ID。 |
| Prompt.HydratedEntities.Entity.Subject | イベント エンティティの件名。 |
| Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl | イベント エンティティの URL。 |
| Prompt.HydratedEntities.Entity.Start | イベント エンティティの開始時刻。 |
| Prompt.HydratedEntities.Entity.End | イベント エンティティの終了時刻。 |
| Prompt.HydratedEntities.Entity.OrganizerName | 開催者 イベント エンティティの名前。 |
| Prompt.HydratedEntities.Entity.OrganizerAddress | 開催者 イベント エンティティのアドレス。 |
| Prompt.HydratedEntities.Entity.Attendees | イベント エンティティの出席者の一覧。 |