知識マップ: PesterによるPowerShellのテスト整備 ── 運用スクリプトを壊しにくくする実務の型

記事「PesterによるPowerShellのテスト整備 ── 運用スクリプトを壊しにくくする実務の型」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

この記事はPowerShellの運用スクリプトをPester v5で壊しにくくする実務手順を、テスト対象を守る仕組みの関係として整理します。Pesterは$TestDriveで本物のファイルに触れずにファイル操作を検証し、Mockで削除や通知のような危険操作を実行せず呼び出し条件だけを確認します。削除対象を選ぶ関数を危険な変更処理より先に切り出してテストし、日時をGet-Dateの直接呼び出しではなく引数として渡すことでテストの不安定性を防ぎます。GitHub ActionsやAzure PipelinesはPesterの実行を自動化しますが、Windowsに同梱される旧バージョンのPesterとは別に明示的な再インストールが必要で、社内プロキシやTLS設定がInstall-Moduleによるモジュール導入を妨げることもあります。

flowchart LR
    accTitle: PesterによるPowerShellテスト整備の知識マップ
    accDescr: PesterがPowerShellスクリプトを検証するテストフレームワークであり、TestDriveでファイル操作を、Mockで削除等の危険操作を安全に検証し、対象選定関数を危険操作より先に固め、日時を引数化してテストの不安定性を防ぎ、GitHub ActionsやAzure PipelinesでCIとして自動化する一方、Windows同梱の旧バージョンとの違いや社内プロキシによる導入阻害に注意する必要があることを示す図
    pester["Pester"]
    powershell["PowerShell"]
    pester_testdrive["$TestDrive"]
    pester_mock["Pesterのモック(Mock)"]
    pester_tag["Pesterのタグ(Tag)"]
    pester_code_coverage["PesterのCode Coverage"]
    supportsshouldprocess["SupportsShouldProcess(-WhatIf)"]
    destructive_operation_powershell["危険操作(削除・移動・上書きなど)"]
    github_actions["GitHub Actions"]
    azure_pipelines["Azure Pipelines"]
    corporate_proxy_module_install_blocker["社内プロキシ/TLSによるモジュール導入の阻害"]
    install_module_powershellgallery["Install-ModuleによるPowerShell Galleryからの導入"]
    closed_network["閉域ネットワーク"]
    target_selection_function["対象選定を切り出した関数"]
    date_argument_injection["日付の引数化(Now引数)"]
    test_flakiness["テストの不安定性(flaky test)"]
    pester -->|"利用する"| powershell
    pester -->|"利用する"| pester_testdrive
    pester -->|"利用する"| pester_mock
    pester -->|"利用する"| pester_tag
    pester -->|"利用する"| pester_code_coverage
    supportsshouldprocess -->|"軽減する"| destructive_operation_powershell
    pester_mock -->|"推奨される対応"| destructive_operation_powershell
    pester_testdrive -->|"軽減する"| destructive_operation_powershell
    github_actions -->|"自動化する"| pester
    azure_pipelines -->|"自動化する"| pester
    corporate_proxy_module_install_blocker -.->|"両立しない"| install_module_powershellgallery
    closed_network -->|"両立しない"| install_module_powershellgallery
    destructive_operation_powershell -->|"で確認できる"| pester_mock
    github_actions -.->|"利用する"| pester_tag
    install_module_powershellgallery -->|"前提とする"| powershell
    target_selection_function -->|"より先に行うべき"| destructive_operation_powershell
    date_argument_injection -.->|"防止する"| test_flakiness
    target_selection_function -.->|"利用する"| date_argument_injection

概念間の関係(全18件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

• PesterはPowerShellを利用します。PesterはPowerShellスクリプトを検証するために書かれたPowerShell用のテストフレームワークである / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Pesterは$TestDriveを利用します。Pesterはテストごとに$TestDriveという一時フォルダーを用意し、本物のファイルを使わずにファイル操作を検証できるようにする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• PesterはPesterのモック(Mock)を利用します。Pesterは実際のコマンド呼び出しをMockで置き換え、呼ばれた回数や引数を検証できるようにする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• PesterはPesterのタグ(Tag)を利用します。PesterはDescribe/Context/Itにタグを付け、TagFilter/ExcludeTagFilterで実行対象を絞り込める / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• PesterはPesterのCode Coverageを利用します。Pesterはテスト対象スクリプトの実行済み行を計測するCode Coverage機能を持つ / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• SupportsShouldProcess(-WhatIf)は危険操作(削除・移動・上書きなど)を軽減します。SupportsShouldProcessを付けると-WhatIfで危険操作を予行でき、実行前に対象を確認できるため事故のリスクを軽減する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Pesterのモック(Mock)は危険操作(削除・移動・上書きなど)に対する本記事の推奨です。削除・移動・Web API呼び出し・通知のような実行してはいけない処理はMockで置き換えるのが実務での推奨である / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• $TestDriveは危険操作(削除・移動・上書きなど)を軽減します。$TestDriveを使う習慣をつけると、危険操作のテストで本物のファイルを誤って消すような事故を防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• GitHub ActionsはPesterを自動化します。GitHub Actionsのワークフローは、Pester v5をInstall-Moduleで明示的に入れたうえでInvoke-Pesterの実行をコミット・プルリクエストごとに自動化する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• Azure PipelinesはPesterを自動化します。Azure PipelinesのPowerShell@2タスクは、Pesterのインストールと実行用スクリプトの呼び出しをパイプラインとして自動化する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 社内プロキシ/TLSによるモジュール導入の阻害はInstall-ModuleによるPowerShell Galleryからの導入と両立しません。社内プロキシ・TLS 1.2未設定・NuGetプロバイダー未導入が重なる環境では、Install-ModuleによるPowerShell Galleryからの導入は成立しない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• 閉域ネットワークはInstall-ModuleによるPowerShell Galleryからの導入と両立しません。閉域ネットワークでは外部のPowerShell Galleryに直接到達できないため、Install-ModuleではなくSave-Moduleでの持ち込みや社内リポジトリ登録が必要になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 危険操作(削除・移動・上書きなど)はPesterのモック(Mock)で確認できます。削除・移動などの危険操作を実際に実行せず、Mockで呼ばれるべき場面で呼ばれたか・呼ばれてはいけない場面で呼ばれていないかを確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• GitHub ActionsはPesterのタグ(Tag)を利用します。PesterでPowerShellのテストを実行するCIでは、環境依存や遅いテストを除外し、TagFilterで絞ったUnitタグのテストを標準実行するのが実務的である / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• Install-ModuleによるPowerShell Galleryからの導入はPowerShellを前提とします。Install-ModuleはPowerShellのコマンドレットであり、PowerShell Galleryからモジュールを取得する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 対象選定を切り出した関数は危険操作(削除・移動・上書きなど)より先に行うべきです。危険な処理を実装・テストする前に、対象を選ぶ判断のロジックを独立した関数として切り出し、先にテストで固めておくべきである / 確度: 確立した関係 / 確認日: 2026-08-01 出典
• 日付の引数化(Now引数)はテストの不安定性(flaky test)を防ぎます。日時を-Nowのような引数として外から渡せるようにすると、実行日によって結果が変わるという原因に限り、テストの不安定さを防げる(タイミング依存や外部サービスなど実行日時以外が原因の不安定さには別の対策が要る) / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
• 対象選定を切り出した関数は日付の引数化(Now引数)を利用します。現在時刻を選定条件に使う場合、対象選定関数(記事の例ではGet-OldLogFile)は$Nowをテストしやすくするために引数として受け取り、関数内でGet-Dateを直接使わないことでテスト実行日に依存しない対象選定を可能にしている / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

Pester

PowerShellスクリプトの自動テストを書くためのテストフレームワーク。

PowerShell

オブジェクトパイプラインとエラー処理機構を持つ、Microsoftが最も堅牢で最新のWindows自動化に推奨するコマンドラインシェル兼スクリプト言語。

SupportsShouldProcess(-WhatIf)

PowerShellの関数に-WhatIf/-Confirmパラメーターを持たせ、実行前に何が行われるかを予行確認できるようにするCmdletBindingの機構。

Pesterのモック(Mock)

Pesterが提供する、実際のコマンドの呼び出しをテスト用の代替実装に差し替える機能。

$TestDrive

Pesterがテストごとに用意する、テスト終了時に自動的に削除される一時フォルダーを指す変数。

GitHub Actions

GitHubが提供する、リポジトリのイベントをトリガーにワークフローを実行するCI/CDサービス。

Azure Pipelines

Microsoftが提供する、ビルド・テスト・デプロイのパイプラインを実行するCI/CDサービス。

社内プロキシ/TLSによるモジュール導入の阻害

社内プロキシ未設定・TLS 1.2未有効・NuGetプロバイダー未導入などが重なり、社内端末からのInstall-ModuleがPowerShell Galleryに到達できず失敗する状態。

閉域ネットワーク

インターネットに接続せずに運用する隔離されたネットワーク。

危険操作(削除・移動・上書きなど)

削除・移動・上書き・サービス再起動・権限変更のような、少しの条件ミスが事故につながるPowerShellの変更操作。

Install-ModuleによるPowerShell Galleryからの導入

PowerShell Galleryが公開するモジュールを、Install-Moduleコマンドレットでローカルにインストールする手段。

対象選定を切り出した関数

削除・移動などの変更処理から、対象を選ぶロジックだけを独立した関数として切り出す設計。戻り値をテストで確認しやすくする。

日付の引数化(Now引数)

関数内でGet-Dateを直接使わず、日時を引数として外部から渡せるようにする設計。テストで日付を固定できるようにする。

機械可読データ

• JSON-LD / Turtle ── この記事の知識グラフ全体
• 概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。