知識マップ: PowerShellモジュールの社内配布と更新 ── PSResourceGetと社内リポジトリ

記事「PowerShellモジュールの社内配布と更新 ── PSResourceGetと社内リポジトリ」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

この記事は共有フォルダーでのps1配布から卒業し、PowerShell 7.4に同梱されるPSResourceGetで社内リポジトリを構築・運用する方法を扱います。PSResourceGetは従来のPowerShellGetの後継として、Register-PSResourceRepositoryで登録したリポジトリに対しPublish-PSResource・Install-PSResource・Update-PSResourceで公開・取得・更新を行います。マニフェストにバージョンとFunctionsToExportを配列で明示することが内部関数の意図しない公開を防ぎ、共有フォルダーのアクセス制御が配布の実質的なセキュリティ境界になります。無人実行にはAllUsersスコープと管理者権限が必要で、実行ポリシーAllSignedの環境では各ファイルへのAuthenticode署名が必須であり、カタログ署名だけではこの要件を満たせません。

flowchart LR
    accTitle: PSResourceGetによるモジュール社内配布の知識マップ
    accDescr: PSResourceGetが従来のPowerShellGetを置き換え社内リポジトリでの公開・取得・更新を担うこと、マニフェストとFunctionsToExportの明示が内部関数の意図しない公開を防ぐこと、共有フォルダーのアクセス制御がセキュリティ境界になること、AllSigned環境ではAuthenticode署名が必須でカタログ署名だけでは満たせないことの関係を示す図
    psresourceget["PSResourceGet(Microsoft.PowerShell.PSResourceGet)"]
    internal_module_repository["社内リポジトリ(PSResourceGet)"]
    powershellget_2["PowerShellGet 2.2.5(従来版)"]
    register_psresourcerepository["Register-PSResourceRepository"]
    repository_share_acl["社内リポジトリ共有フォルダーのアクセス制御"]
    publish_psresource["Publish-PSResource"]
    install_psresource["Install-PSResource"]
    update_psresource["Update-PSResource"]
    install_scope["-Scope(CurrentUser/AllUsers)"]
    task_scheduler["タスクスケジューラの無人実行"]
    admin_rights["管理者権限"]
    module_versioning_semver["セマンティックバージョニング(モジュール)"]
    module_manifest["モジュールマニフェスト(.psd1)"]
    prerelease_version["プレリリース版(PrivateData.PSData.Prerelease)"]
    functionstoexport_wildcard["FunctionsToExportのワイルドカード指定('*')"]
    internal_function_exposure["内部関数の意図しない公開"]
    functionstoexport_explicit["FunctionsToExportの配列明示"]
    authenticode_signature["Authenticode署名(スクリプトファイル)"]
    code_signing_cert["コード署名証明書"]
    code_signing_timestamp["コード署名のタイムスタンプ"]
    allsigned_execution_policy["実行ポリシーAllSigned"]
    file_catalog_signing["カタログ署名(New-FileCatalog)"]
    psmodulepath["$env:PSModulePath(モジュールの探索パス)"]
    psresourceget -->|"の後継"| powershellget_2
    psresourceget -->|"利用する"| internal_module_repository
    internal_module_repository -->|"で構成できる"| register_psresourcerepository
    internal_module_repository -.->|"前提とする"| repository_share_acl
    psresourceget -->|"利用する"| publish_psresource
    psresourceget -->|"利用する"| install_psresource
    psresourceget -->|"利用する"| update_psresource
    install_psresource -->|"利用する"| install_scope
    task_scheduler -.->|"前提とする"| install_scope
    install_scope -.->|"前提とする"| admin_rights
    module_versioning_semver -->|"推奨される対応"| module_manifest
    module_manifest -.->|"利用する"| prerelease_version
    functionstoexport_wildcard -->|"原因になり得る"| internal_function_exposure
    functionstoexport_explicit -->|"防止する"| internal_function_exposure
    functionstoexport_explicit -->|"推奨される対応"| module_manifest
    authenticode_signature -->|"利用する"| code_signing_cert
    authenticode_signature -.->|"利用する"| code_signing_timestamp
    allsigned_execution_policy -->|"前提とする"| authenticode_signature
    install_psresource -->|"利用する"| file_catalog_signing
    authenticode_signature -.->|"推奨される対応"| internal_module_repository
    install_psresource -->|"前提とする"| psmodulepath
    internal_module_repository -.->|"前提とする"| module_manifest

概念間の関係(全22件)

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

PSResourceGet(Microsoft.PowerShell.PSResourceGet)はPowerShellGet 2.2.5(従来版)の後継に当たります。PSResourceGetは従来のPowerShellGetとPackageManagementを置き換えるものとして提供され、PowerShellGet 2.2.5と並存できる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PSResourceGet(Microsoft.PowerShell.PSResourceGet)は社内リポジトリ(PSResourceGet)を利用します。PSResourceGetはRegister-PSResourceRepositoryで登録した社内リポジトリを検索・取得先として利用できる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
社内リポジトリ(PSResourceGet)はRegister-PSResourceRepositoryで構成できます。社内リポジトリはRegister-PSResourceRepositoryにファイル共有のUNCパスやNuGet互換フィードのURLを指定して登録する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
社内リポジトリ(PSResourceGet)は社内リポジトリ共有フォルダーのアクセス制御を前提とします。社内リポジトリはファイル共有(UNCパス)としても構成できる。その場合は、配布担当者だけが書き込めるアクセス制御が実質的なセキュリティ境界になる。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
PSResourceGet(Microsoft.PowerShell.PSResourceGet)はPublish-PSResourceを利用します。モジュールの公開はPublish-PSResourceで行う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PSResourceGet(Microsoft.PowerShell.PSResourceGet)はInstall-PSResourceを利用します。モジュールの取得はInstall-PSResourceで行う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
PSResourceGet(Microsoft.PowerShell.PSResourceGet)はUpdate-PSResourceを利用します。配布済みモジュールの更新はUpdate-PSResourceで行う。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Install-PSResourceは-Scope(CurrentUser/AllUsers)を利用します。Install-PSResourceは-ScopeでCurrentUserとAllUsersのどちらにインストールするかを指定する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
タスクスケジューラの無人実行は-Scope(CurrentUser/AllUsers)を前提とします。タスクスケジューラからPowerShellスクリプトを無人実行し、そのスクリプトがインストール済みモジュールをimportする場合、モジュールはサービスアカウントから見える場所(AllUsers、またはそのアカウント自身の環境)にインストールされている必要がある。EXEや組み込みコマンドだけを実行するタスクにはこの前提はない。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
-Scope(CurrentUser/AllUsers)は管理者権限を前提とします。-Scope AllUsersを選んだ場合、全ユーザー共通の場所(Program Files配下)へ書き込むため、管理者として起動したPowerShellでないと失敗する。CurrentUserではこの制約はない。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
セマンティックバージョニング(モジュール)はモジュールマニフェスト(.psd1)に対する本記事の推奨です。マニフェストのModuleVersionは、破壊的変更をメジャーで表現するセマンティックバージョニングで付けることが推奨される。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
モジュールマニフェスト(.psd1)はプレリリース版(PrivateData.PSData.Prerelease)を利用します。検証用のプレリリース版として公開したい場合、マニフェストのPrivateData.PSData.Prereleaseに文字列を設定すると、そのように公開できる。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
FunctionsToExportのワイルドカード指定('*')は内部関数の意図しない公開の原因になることがあります。FunctionsToExportをワイルドカードにすると、内部のヘルパー関数まで意図せず公開され、事実上の公開APIになってしまう。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
FunctionsToExportの配列明示は内部関数の意図しない公開を防ぎます。FunctionsToExportを配列で明示すれば、内部関数が意図せず公開されることを防げる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
FunctionsToExportの配列明示はモジュールマニフェスト(.psd1)に対する本記事の推奨です。FunctionsToExportは配列で明示する書き方が、マニフェストの実務として推奨される。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Authenticode署名(スクリプトファイル)はコード署名証明書を利用します。Authenticode署名はコード署名証明書を使って各スクリプトファイルの発行元と完全性を保証する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Authenticode署名(スクリプトファイル)はコード署名のタイムスタンプを利用します。証明書の有効期限が切れた後も署名を有効なままにしたい場合、タイムスタンプを付けて署名すると、有効期限切れ後も署名が有効なままになる。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
実行ポリシーAllSignedはAuthenticode署名(スクリプトファイル)を前提とします。実行ポリシーAllSignedは、実行しようとする各.ps1/.psm1ファイル自体のAuthenticode署名を検証する。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Install-PSResourceはカタログ署名(New-FileCatalog)を利用します。Install-PSResourceは-AuthenticodeCheckで署名・カタログの検証を行える。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Authenticode署名(スクリプトファイル)は社内リポジトリ(PSResourceGet)に対する本記事の推奨です。AllSigned環境の利用者へ配布するモジュールでは、公開前に各ファイルへAuthenticode署名しておくことが推奨される。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Install-PSResourceは$env:PSModulePath(モジュールの探索パス)を前提とします。Install-PSResourceで入れたモジュールも、最終的には$env:PSModulePathに列挙されたフォルダーから検索されて読み込まれる。 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
社内リポジトリ(PSResourceGet)はモジュールマニフェスト(.psd1)を前提とします。リポジトリに公開・配布するモジュールには、バージョン番号を持つマニフェスト(.psd1)が実務上必須になる。マニフェストなしでも.psm1単体をモジュールとして読み込むこと自体は可能だが、その場合バージョン管理ができない。 / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

PSResourceGet(Microsoft.PowerShell.PSResourceGet): 従来のPowerShellGetとPackageManagementを置き換える、PowerShellのモジュール・パッケージ管理の仕組み。PowerShell 7.4に同梱され、従来のPowerShellGet 2.2.5と並存できる。
社内リポジトリ(PSResourceGet): Register-PSResourceRepositoryで登録する、社内向けにモジュールを配布・取得するためのリポジトリ。ファイル共有(UNCパス)またはNuGet互換フィードとして構成できる。
Install-PSResource: リポジトリからモジュールを取得してインストールするコマンドレット。-Name・-Version・-Repository・-Scopeなどで対象と配置先を指定する。
タスクスケジューラの無人実行: 指定したアカウントで、スケジュールやログオンなどのトリガーに従いプログラムを実行するWindowsの仕組み。ログオン種別(対話トークン・パスワード保存・S4Uなど)の設定によっては、ユーザーがログオンしていなくても実行できる。
-Scope(CurrentUser/AllUsers): Install-PSResourceでモジュールをインストールする範囲を指定するパラメーター。CurrentUserはユーザー個別の場所、AllUsersは全ユーザー共通の場所(Program Files配下)に書き込む。
セマンティックバージョニング(モジュール): メジャー.マイナー.パッチの形式で、破壊的変更を必ずメジャーで表現するバージョン付けの規約。
モジュールマニフェスト(.psd1): モジュールのバージョン番号・公開する関数・依存モジュール・対応するPowerShellのバージョンやエディションを宣言するファイル。New-ModuleManifestで雛形を作成する。
FunctionsToExportのワイルドカード指定('*'): モジュールの公開関数をワイルドカードで指定するマニフェストの書き方。モジュール本体を解析しないと公開関数が分からないためコマンド探索が遅くなる。
FunctionsToExportの配列明示: モジュールの公開関数をワイルドカードではなく配列で明示するマニフェストの書き方。コマンド探索が速くなり、内部関数の意図しない公開も防げる。
Authenticode署名(スクリプトファイル): 個々の.ps1・.psm1ファイルの発行元と完全性を担保する署名。実行ポリシーAllSignedはこの署名を検証する。
実行ポリシーAllSigned: ローカル作成分も含むすべてのスクリプトと構成ファイルに、信頼された発行元によるAuthenticode署名を要求する実行ポリシーの値。未分類の発行元は実行前に確認を求める。

機械可読データ

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

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