トップ > Copilot > 【Microsoft×生成AI連載】【Copilot Notebook】PowerShellスクリプトをナレッジに追加して運用マニュアルを自動生成してみた

【Microsoft×生成AI連載】【Copilot Notebook】PowerShellスクリプトをナレッジに追加して運用マニュアルを自動生成してみた

Copilot Microsoft Copilot Microsoft 365 Copilot 生成AI Microsoft×生成AI連載

PowerShell スクリプトは業務の運用自動化に欠かせない一方で、その処理内容や実行手順をドキュメント化する作業には手間がかかります。特に複数のスクリプトファイルで構成される処理では、全体像を整理して運用マニュアルとしてまとめることは容易ではありません。

しかし、Copilot Notebook のナレッジ（参照）を活用すると、複数の PowerShell スクリプトをまとめて解析し、処理内容を構造化された運用マニュアルとして自動生成できます。

本記事では、PowerShell スクリプトを Copilot Notebook のナレッジとして登録し、運用マニュアルを自動生成する方法を紹介します。

スクリプトの文書化に時間をかけたくない IT 運用担当・情報システム担当の方をはじめ、スクリプトの文書化に悩まれている方にぜひ読んでいただきたい内容となっております。

これまでの連載

これまでの連載記事一覧はこちらの記事にまとめておりますので、過去の連載を確認されたい方はこちらの記載をご参照ください。

blog.jbs.co.jp

機能概要

Copilot Notebook とは

Copilot Notebook は、Microsoft 365 Copilot に搭載された AI ワークスペースです。プロジェクトや業務に必要なファイル・メモ・リンクをまとめて登録し、その範囲に絞って Copilot に質問・生成依頼ができます。

通常の Copilot Chat がテナント全体の情報や Web を参照するのに対し、Copilot Notebook は登録したナレッジ（参照）だけを根拠に回答を生成します。「この3本のスクリプトについてだけ答えてほしい」というような、スコープを絞ったやり取りができる点が特徴です。

Microsoft 365 Copilot の 「チャット」 > 「ノートブック」 からCopilot Notebookを利用できます。

ナレッジ（参照）の仕組み

Copilot Notebook では、「参照」としてファイルや SharePoint サイト・フォルダーなどを登録することで、Copilot の回答範囲をそのコンテンツに限定できます。登録した参照は常に最新の状態で同期されるため、スクリプトを更新した際に改めて再登録する必要はありません。

ただし、Copilot Notebook が対応しているファイル形式には制限があります。

  • 参照として登録できるソース：SharePoint サイト・ドキュメントライブラリ・フォルダー、OneDrive ファイル、公開 Web サイト など
  • 対応テキスト形式の例：.txt、.xlsx、.docx、.pdf など
  • 非対応形式の例：.ps1、.exe、.zip など

PowerShell スクリプトの拡張子である .ps1 はサポート対象外です。そのため、Copilot Notebook が対応している .txt に変更したうえで利用します。

ファイル名はそのままに、拡張子だけ .txt に変更することで、スクリプトの内容を Copilot に読み込ませることができます。

※ Copilot Notebook の利用には Microsoft 365 Copilot ライセンスが必要です。ノートブックの作成には SharePoint または OneDrive のサービス プランも必要となります。

PowerShellスクリプトをナレッジに追加して運用マニュアルを自動生成してみた

ここからは、「SharePoint Online のリスト情報をもとに Exchange Online へ会議室を作成する複数のスクリプト」を題材に、Copilot Notebook で運用マニュアルを生成するまでの流れを順番に紹介します。

手順1：スクリプトファイルの拡張子を .txt に変更して OneDrive にアップロードする

まず、Copilot Notebook に読み込ませるスクリプトファイルを複製して、拡張子を .ps1 から .txt に変更します。ファイルの中身はそのままで、拡張子だけを変更します。

今回は以下の3ファイルを対象にしました。

  • Main.txt（旧: Main.ps1）　全体の処理を記述しているスクリプト
  • Functions.txt（旧: Functions.ps1）　SharePoint Online のリスト情報取得、Exchange Online に会議室メールボックスを作成するなどの処理を記述しているスクリプト
  • app.txt（旧: app.config）　接続先テナントや各種パラメーターを定義した設定ファイル

拡張子の変更後、3ファイルをまとめて OneDrive の任意のフォルダー（例：「PowerShellスクリプト」フォルダー）にアップロードします。

※ SharePoint のドキュメントライブラリに置く場合も同様の手順で登録できます。

手順2：Copilot Notebook にナレッジ（参照）として追加する

次に、Copilot Notebook を開き、アップロードしたファイルを参照として登録します。

Microsoft 365 Copilot アプリを開き、左メニューから「ノートブック」を選択して既存のノートブックを開きます。

※ 新規作成したい場合は「新しいノートブック」から作成してください。

右ペインの「参照を追加」をクリックします。

検索バーにファイル名を入力するか、OneDrive を参照してファイルを選択します。

Main.txt、Functions.txt、app.txtの3つを選択し、「追加」をクリックします。

参照が追加されると、Copilot の回答は Copilot Notebook に登録されたこれら 3 ファイルの内容を根拠として生成されるようになります。複数ファイルにまたがる処理の関係性も、まとめて読み込んで解釈してくれます。

手順3：Copilot に運用マニュアルの生成を依頼する

ナレッジ（参照）を設定したら、チャット欄に指示を入力してマニュアルを生成します。以下のようなプロンプトを試してみました。

登録しているスクリプトファイルを読み込んで、IT 運用担当者向けの運用マニュアルを作成してください。ただし、スクリプト実行時のファイル拡張子は「.ps1」または「.config」に変換されるものとします。
マニュアルには以下の項目を含めてください。
・スクリプト全体の処理概要
・各スクリプトの役割と処理の流れ
・実行前に準備が必要な設定や権限
・実行手順（コマンド例を含む）
・注意事項とよくあるエラーへの対処方法

チャット上で運用マニュアルが生成されました。スクリプト間の呼び出し関係が整理され、「Main.ps1 で app.config と Functions.ps1 を読み込み、SharePoint Online のリスト情報をもとに Exchange Online へ会議室を作成する」という構造を Copilot が自動的に読み解いて出力してくれました。

また、マニュアルを Word に出力することも可能です。生成された回答の一番下の「…」をクリックし、「エクスポート先」 > 「Word」をクリックします。

Word に出力されると、確認したい章にアクセスしやすくなるため、より運用マニュアルとして扱いやすくなります。

利用シーンとメリット、注意点

利用シーン

Copilot Notebook へのスクリプト登録は、ドキュメント化の負荷を減らしたい場面で効果を発揮します。

  • 引き継ぎ資料の作成：担当者交代の際などに、スクリプトを元にマニュアルの初稿を生成したいとき
  • 既存スクリプトの棚卸し：複数のスクリプトをまとめて登録し、処理全体の流れを把握したいとき
  • 社内向けナレッジ化：Copilot Notebook を「このスクリプト群の専用 Q&A 窓口」として活用し、担当者への問い合わせ対応を削減したいとき

メリット

Copilot Notebook へのスクリプト登録で、文書化の効率が大幅に上がります。

  • 複数ファイルにまたがる処理でも、Copilot がスクリプト間の関係を読み解いてまとめてくれる
  • 「ナレッジ（参照）」は OneDrive と同期されるため、スクリプトを更新しても Copilot Notebook での回答に自動で反映される
  • プロンプトを変えるだけで、「運用マニュアル」「トラブルシューティング手順書」「新人向け説明資料」など、用途に合わせた複数の文書を生成できる

注意点

運用時には、いくつかの制約と注意点を把握しておく必要があります。

  • ナレッジ登録
    • デバイスからの直接アップロードでは .txt ファイルが登録できないケースがある
    • OneDrive または SharePoint 経由での登録を推奨する
    • ナレッジ（参照）追加時は「参照」ボタンから OneDrive または SharePoint を指定する方法を利用する
  • 生成精度
    • 生成されたマニュアルの内容は、スクリプトのコメント有無や変数名の明確さに左右される可能性がある
    • コメントが少ないスクリプトは Copilot Notebook での解釈精度が下がる可能性がある
  • 生成結果の確認
    • Copilot が生成した内容には誤りが含まれる可能性がある
    • 実際の運用に使用する前に担当者が必ず確認し、必要に応じて実際のスクリプトの動作と照合する

まとめ

本記事では、PowerShell スクリプトの拡張子を .txt に変更して OneDrive へアップロードし、 Copilot Notebook のナレッジ（参照）として登録することで、運用マニュアルを自動生成する方法をご紹介しました。

複数ファイルにまたがるスクリプトでも Copilot がまとめて読み解いてくれるため、「スクリプトは動くがドキュメントがない」という状態を一気に解消できます。プロンプトを変えることで、マニュアルの切り口を自由に変えられる点も、実務での応用範囲を広げてくれます。

まずは手元の引き継ぎ用スクリプトを1本 .txt に変えて、 Copilot Notebook に登録するところから試してみてください。

おまけ（Copilot Chatによる本記事の要約）

本記事ここまでの執筆内容をCopilot Chatに転記し、記事内容の要約をしてもらいました。

【要約：PowerShellスクリプトをCopilot Notebookのナレッジに追加して運用マニュアルを自動生成してみた】

概要

PowerShell スクリプトの拡張子を .txt に変更して OneDrive にアップロードし、Copilot Notebook のナレッジ（参照）として登録することで、IT 運用担当者向けの運用マニュアルを自動生成できます。複数ファイルにまたがる処理でも、Copilot がスクリプト間の関係を読み解いてまとめてくれます。

基本の流れ

  • .ps1 ファイルの拡張子を .txt に変更し、OneDrive にアップロードする
  • Copilot Notebook の「参照」に OneDrive / SharePoint 経由でファイルを追加する
  • プロンプトでマニュアル生成を依頼し、草稿を得る

メリット

  • 複数スクリプトの関係性を Copilot がまとめて解釈してくれる
  • OneDrive 同期により、スクリプト更新後も参照を追加し直す必要がない
  • プロンプトを変えることで、用途別の複数文書を生成できる

注意点

  • デバイスから直接 .txt をアップロードできないケースがあるため、OneDrive / SharePoint 経由を推奨
  • スクリプトのコメントが少ないと生成精度が下がる場合がある
  • 生成内容は必ず担当者が実際のスクリプトと照合して確認すること
執筆担当者プロフィール
梶野 礼佳

梶野 礼佳（日本ビジネスシステムズ株式会社）

Webシステムやバッチなどの開発を経験し、現在はAIの部署に所属しています。AI分野に関しては勉強中の初心者です。

担当記事一覧