PowerShell Gallery入門：モジュール検索・インストール方法

By /

はい、承知いたしました。PowerShell Galleryのモジュール検索・インストール方法に焦点を当て、約5000語の詳細な入門記事を作成します。

PowerShell Gallery入門：モジュール検索・インストール方法の詳細

はじめに：PowerShell Galleryとは？なぜそれを使うのか？

PowerShellは、Windows、macOS、Linuxなどのプラットフォームでシステム管理や自動化を行うための強力なスクリプト言語およびコマンドシェルです。PowerShellの大きな強みの一つに、「モジュール」という概念があります。モジュールは、関連するコマンドレット（PowerShellのコマンド）や関数、変数などを一つのパッケージにまとめたものです。これにより、特定の管理タスク（例：Active Directory、Azure、Microsoft 365、VMwareの管理など）に必要なコマンド群を効率的に利用できます。

しかし、世界中にいるPowerShellユーザーや開発者が作成した便利なモジュールを、どのように見つけて、どのように自分の環境に導入すれば良いのでしょうか？その答えが PowerShell Gallery です。

PowerShell Gallery (www.powershellgallery.com) は、PowerShellモジュール、スクリプト、DSCリソースなどの発見、共有、インストールのための中央リポジトリです。Microsoftによってホストされており、コミュニティによって開発された何万ものパッケージが公開されています。

PowerShell Galleryを利用するメリットは多岐にわたります。

  1. 容易な発見と検索: 特定の目的に合ったモジュールを簡単に見つけられます。キーワード検索、タグによるフィルタリング、コマンドレット名による検索など、様々な方法で目的のモジュールを探せます。
  2. 簡単なインストールと更新: Install-Moduleコマンドレットを使えば、インターネット経由でモジュールをダウンロードし、PowerShellが認識できる適切な場所に自動的に配置できます。更新もUpdate-Moduleコマンドレット一つで簡単に行えます。
  3. 依存関係の自動解決: 多くのモジュールは、他のモジュールや特定のPowerShellバージョンに依存しています。Install-Moduleは、必要な依存関係を自動的に識別し、同時にインストールしてくれます。
  4. 信頼性の向上: PowerShell Galleryに公開される多くのモジュールは、署名されており、ある程度の検証プロセスを経ています。これにより、信頼性の低いソースからダウンロードするリスクを軽減できます（ただし、完全にリスクがないわけではありません。常に注意が必要です）。
  5. コミュニティとの連携: 自分で作成したモジュールを公開したり、他のユーザーが作成したモジュールに貢献したりすることで、PowerShellコミュニティと連携できます。
  6. オフライン環境への対応: Save-Moduleコマンドレットを使えば、インターネット接続がある環境でモジュールをダウンロードしておき、それをオフライン環境に持ち込んでインストールすることも可能です。

この記事では、PowerShell Galleryを使い始めるために必要な基本的なコマンドレット、特にモジュールの「検索 (Find-Module)」と「インストール (Install-Module)」に焦点を当て、それぞれの機能、使い方、様々なオプション、そして関連する概念（リポジトリ、スコープ、依存関係、セキュリティ）について詳細に解説します。

PowerShell Galleryをマスターすることは、PowerShellによる管理作業の効率を劇的に向上させるための第一歩です。さあ、その世界に踏み込みましょう。

前提条件と準備

PowerShell Galleryからモジュールをインストールするためには、いくつかの前提条件があります。

  1. PowerShellのバージョン: PowerShell Galleryとのインタラクションは、主にPackageManagementおよびPowerShellGetというPowerShellモジュールによって実現されます。これらのモジュールは、PowerShell 5.0以降にデフォルトで含まれています。もしPowerShell 4.0以前を使用している場合は、PowerShell 5.0以降（またはクロスプラットフォーム対応のPowerShell Core / PowerShell 7以降）にアップグレードすることを強く推奨します。Windows 10以降ではPowerShell 5.1が標準で搭載されています。
    • PowerShellのバージョン確認： $PSVersionTable.PSVersion
  2. インターネット接続: PowerShell Galleryはオンラインのリポジトリです。モジュールの検索、ダウンロード、インストールにはインターネット接続が必要です。プロキシ環境下の場合は、PowerShellがプロキシを介してインターネットに接続できるよう設定が必要になることがあります。
  3. 実行ポリシー: PowerShellの実行ポリシーは、スクリプトの実行を許可するかどうかを制御するセキュリティ機能です。ギャラリーからインストールしたモジュールに含まれるスクリプトやコマンドレットを実行するためには、適切な実行ポリシーが設定されている必要があります。通常はRemoteSignedまたはAllSignedが推奨されます。
    • 現在の実行ポリシー確認： Get-ExecutionPolicy
    • 実行ポリシーの変更（管理者権限が必要な場合あり）： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser (現在のユーザーに対して設定する場合) または Set-ExecutionPolicy RemoteSigned (全てのユーザーに対して設定する場合 – 要管理者権限)
    • 注: Install-Module自体は通常、実行ポリシーの影響を受けません。しかし、インストールしたモジュールを使おうとすると、実行ポリシーが関係してきます。
  4. 管理者権限 (必要に応じて): モジュールをシステム全体のすべてのユーザーが利用できるようにインストールする場合（Install-Module -Scope AllUsers）、管理者権限が必要です。現在のユーザーのみが利用できるようにインストールする場合（Install-Module -Scope CurrentUser）は、通常管理者権限は必要ありません。どちらのスコープでインストールするかは、モジュールの用途や環境によって選択します。
  5. PowerShellGetモジュールの更新 (推奨): PowerShell Galleryとの連携を担うPowerShellGetモジュールは、日々改善されています。最新の機能を利用したり、既知の問題を回避したりするために、PowerShellGetモジュール自体を最新版に更新しておくことが推奨されます。
    • Install-Module PowerShellGet -Force -AllowClobber
    • このコマンドは、PowerShellGetモジュールを強制的に（既存バージョンがあっても上書きして）インストールします。AllowClobberは、古いバージョンとコマンドレット名が重複する場合に上書きを許可するオプションです。このコマンドの実行には、通常管理者権限が必要です（AllUsersスコープにインストールされるため）。もし管理者権限がない場合は、-Scope CurrentUserを付けて自分自身のユーザープロファイルにインストールすることも可能です。

これらの準備が整えば、PowerShell Galleryからモジュールを検索し、インストールする準備は完了です。

PowerShell Galleryからのモジュール検索 (Find-Module)

PowerShell Galleryには膨大な数のモジュールが公開されています。目的のモジュールを見つけるには、Find-Moduleコマンドレットを使用します。このコマンドレットは、PowerShell Gallery（または登録されている他のリポジトリ）を検索し、利用可能なモジュール情報を取得します。

Find-Moduleの基本的な使い方

最も基本的な使い方は、検索したいモジュール名やキーワードを指定することです。

powershell
Find-Module -Name AzureAD

このコマンドは、”AzureAD”という名前のモジュールを検索します。完全に一致する名前だけでなく、部分的な一致や関連性の高いモジュールも表示されることがあります。

powershell
Find-Module -Name *Azure*

ワイルドカード(*)を使うと、名前に”Azure”を含む全てのモジュールを検索できます。

powershell
Find-Module -Tag ActiveDirectory

-Tagパラメータを使うと、特定のタグが付けられたモジュールを検索できます。開発者はモジュールを公開する際に、そのモジュールの目的や関連技術を示すタグを付けることが推奨されています。

キーワードで検索することも可能です。

powershell
Find-Module -Filter "SQL Server"

-Filterパラメータは、より広範なキーワード検索に使用できます。モジュールの説明やメタデータに含まれるキーワードに基づいて検索が行われます。-Nameはモジュール名に特化しているのに対し、-Filterはより広い範囲を検索します。

Find-Moduleの出力結果を理解する

Find-Moduleを実行すると、通常以下のような情報を含むリストが表示されます。

Version Name Repository Description
------- ---- ---------- -----------
2.0.2.151 AzureAD PSGallery Azure Active Directory V2 General Release Module
2.0.0 Az.Accounts PSGallery Provides cmdlets to sign in and out of Azure contro...
... 他にも多数の結果が表示される可能性があります ...

表示される列は通常以下の通りです。

  • Version: 利用可能なモジュールの最新バージョンまたは指定したバージョン。
  • Name: モジュールの名前。
  • Repository: モジュールが見つかったリポジトリの名前。通常、PowerShell Galleryの場合は”PSGallery”と表示されます。プライベートなリポジトリを登録している場合は、そのリポジトリ名が表示されます。
  • Description: モジュールの簡単な説明。

このリストから、目的のモジュールが見つかったかどうか、どのバージョンが利用可能か、どのリポジトリにあるか、そして簡単な説明を確認できます。

より詳細な情報を取得する

上記の基本的な出力では、モジュールの機能や依存関係、作者などの詳細な情報が分かりません。モジュールの詳細情報を確認するには、Find-Moduleの出力をFormat-Listコマンドレットにパイプするか、特定のプロパティを選択します。

powershell
Find-Module -Name AzureAD | Format-List

このコマンドを実行すると、”AzureAD”モジュールに関する詳細な情報がリスト形式で表示されます。

Version : 2.0.2.151
Name : AzureAD
Type : Module
Repository : PSGallery
Description : Azure Active Directory V2 General Release Module
Author : Microsoft Corporation
CompanyName : Microsoft Corporation
Copyright : Microsoft Corporation. All rights reserved.
PublishedDate : 2023-10-27T14:28:59.0000000+00:00
Cmdlets : {Add-AzureADApplicationOwner, Add-AzureADDeviceRegisteredOwner, Add-AzureADDeviceRegisteredUser, Add-AzureADDirectoryRoleMember...}
Functions : {}
PowerShellGetVersion : 2.2.5
DotNetFrameworkVersion: 4.7.2
Dependencies : {@{Name=AzureAD.Standard.Preview; MinimumVersion=2.0.2.151}}
RepositorySourceLocation: https://www.powershellgallery.com/api/v2
PackageManagementVersion: 1.4.7
Tags : {AzureAD, ActiveDirectory, AAD, Azure, Microsoft, PowerShell, PSModule}
Includes : {Cmdlet, Function, DscResource, Workflow, RoleCapability, ExternalScript, Application, File}
IsLatestVersion : True
Prerelease :
IconUri : https://az835927.vo.msecnd.net/azurescripts/images/AzureAD.png
LicenseUri : https://go.microsoft.com/fwlink/?LinkId=2173303
ProjectUri : https://docs.microsoft.com/en-us/powershell/module/Azuread/
GalleryData : @{PackageRegistration=; Tag=; Dependenices=; Includes=; IsLatestVersion=True; Verified=True; Publishers=System.Object[]}
InstalledLocation :

この詳細情報には、以下のような有用な情報が含まれています。

  • Author: モジュールの作者。
  • CompanyName: モジュールを公開している組織名。
  • PublishedDate: 公開日。
  • Cmdlets / Functions: このモジュールに含まれる主要なコマンドレットや関数の一部リスト。
  • Dependencies: このモジュールが依存している他のモジュールとその最小バージョン。これは、インストール時に自動的に解決されますが、事前に確認するのに役立ちます。
  • Tags: モジュールに関連付けられている全てのタグ。
  • ProjectUri: モジュールのドキュメントやプロジェクトサイトへのリンク。
  • LicenseUri: モジュールのライセンス情報へのリンク。
  • IsLatestVersion: 検索したバージョンが最新版かどうか。
  • IconUri: モジュールのアイコン画像へのリンク（ギャラリーウェブサイトなどで使用されます）。

これらの詳細情報を確認することで、そのモジュールが自分の目的に合っているか、信頼できるソースから提供されているかなどを判断できます。

特定のプロパティだけを表示したい場合は、Select-Objectを使います。

powershell
Find-Module -Name AzureAD | Select-Object Name, Version, Author, Description, Dependencies

これにより、必要な情報だけをコンパクトに確認できます。

特定のバージョンを検索する

デフォルトでは、Find-Moduleは利用可能な最新バージョンを表示します。しかし、過去の特定のバージョンを検索したい場合もあります。

powershell
Find-Module -Name AzureAD -AllVersions

-AllVersionsパラメータを使用すると、指定したモジュールの利用可能な全てのバージョンが表示されます。

powershell
Version Name Repository Description
------- ---- ---------- -----------
2.0.2.151 AzureAD PSGallery Azure Active Directory V2 General Release Module
2.0.2.150 AzureAD PSGallery Azure Active Directory V2 General Release Module
2.0.2.149 AzureAD PSGallery Azure Active Directory V2 General Release Module
... 過去のバージョンが多数表示されます ...
1.0.1 AzureAD PSGallery Azure Active Directory V2 General Release Module

このリストから、インストールしたい特定のバージョンを選択できます。

また、-RequiredVersion、-MinimumVersion、-MaximumVersionなどのパラメータを使って、バージョンを絞り込むことも可能です。

powershell
Find-Module -Name AzureAD -RequiredVersion 2.0.2.151
Find-Module -Name AzureAD -MinimumVersion 2.0.0
Find-Module -Name AzureAD -MaximumVersion 1.9.9

これらのパラメータは、後述するInstall-Moduleでも同様に使用できます。

特定のリポジトリを検索する

PowerShell Gallery (“PSGallery”) 以外にも、独自のプライベートリポジトリや他のサードパーティ製リポジトリをPowerShellに登録して使用できます。デフォルトでは、Find-Moduleは登録されている全てのリポジトリを検索します。特定のリポジトリのみを検索したい場合は、-Repositoryパラメータを使用します。

まず、現在登録されているリポジトリを確認します。

powershell
Get-PSRepository

出力例：

Name SourceLocation InstallationPolicy
---- -------------- ------------------
PSGallery https://www.powershellgallery.com/api/v2 Untrusted
MyInternalRepo \\fileshare\repo Trusted

例えば、”MyInternalRepo”という名前のプライベートリポジトリのみを検索したい場合は、以下のようにします。

powershell
Find-Module -Name InternalModule -Repository MyInternalRepo

-Repositoryパラメータには、複数のリポジトリ名をコンマ区切りで指定することも可能です。

powershell
Find-Module -Name SomeModule -Repository PSGallery, MyInternalRepo

その他の便利な検索オプション

  • -DscResource: モジュールではなく、Desired State Configuration (DSC) リソースのみを検索します。
  • -Script: モジュールではなく、スクリプトのみを検索します。
  • -RoleCapability: Role Capability ファイルのみを検索します（あまり一般的ではありません）。
  • -IncludeDependencies: 検索結果に表示されるモジュールの依存関係も合わせて表示します（詳細表示時に有用）。

powershell
Find-Module -Name AzureAD -IncludeDependencies | Format-List Name, Version, Dependencies

このコマンドは、AzureADモジュールとその依存関係 (AzureAD.Standard.Preview in this case) の情報も一緒に表示します。

PowerShell Gallery Webサイトでの検索

コマンドラインでの検索だけでなく、PowerShell Galleryの公式ウェブサイト (www.powershellgallery.com) を利用してモジュールを視覚的に検索することもできます。

ウェブサイトでは、検索バーにキーワードを入力したり、タグのリストから選択したり、人気のモジュールや最新のモジュールを閲覧したりできます。各モジュールのページには、説明、バージョン履歴、依存関係、含まれるコマンドレットのリスト、作者、ライセンス情報などが掲載されています。

ウェブサイトで目的のモジュールを見つけた後、そのモジュールの名前をコピーして、Install-Moduleコマンドレットでインストールするのが一般的なワークフローです。ウェブサイトは、モジュールの概要を把握したり、複数のモジュールを比較検討したりするのに非常に便利です。

コマンドライン(Find-Module)は自動化やスクリプトからの利用に適しており、ウェブサイトは人間による探索や情報収集に適しています。両者を組み合わせて効果的に利用しましょう。

PowerShell Galleryからのモジュールインストール (Install-Module)

Find-Moduleで目的のモジュールが見つかったら、次はそれを自分の環境にインストールする必要があります。モジュールのインストールには、Install-Moduleコマンドレットを使用します。

Install-Moduleコマンドレットは、PowerShell Gallery（または指定されたリポジトリ）からモジュールのパッケージをダウンロードし、PowerShellがモジュールを認識できる標準的な場所に配置します。これにより、そのモジュールに含まれるコマンドレットや関数をPowerShellセッションで利用できるようになります。

Install-Moduleの基本的な使い方

最も基本的な使い方は、インストールしたいモジュール名を指定することです。

powershell
Install-Module -Name AzureAD

このコマンドを実行すると、以下の処理が行われます。

  1. PowerShell Gallery (PSGallery) を検索し、”AzureAD”という名前の最新バージョンを見つけます。
  2. そのモジュールが依存している他のモジュールがあるかを確認します。
  3. 依存関係を含め、必要な全てのモジュールパッケージをダウンロードします。
  4. ダウンロードしたモジュールを、現在のユーザーのモジュールパス（デフォルトのインストール先）に配置します。
  5. インストール後、通常はそのモジュールに含まれるコマンドレットが自動的にロードされ、利用可能になります（PowerShell 3.0以降の自動ロード機能）。

インストール先については後述の「インストールスコープ」で詳しく解説しますが、デフォルトでは-Scope CurrentUserが適用されます。

インストールスコープ (-Scope)

Install-Moduleを使用する際に最も重要なパラメータの一つが-Scopeです。これは、モジュールをどの場所にインストールするか、そして誰がそのモジュールを利用できるようになるかを制御します。

利用可能なスコープは主に二つです。

  1. CurrentUser: 現在のユーザーのみが利用できる場所にモジュールをインストールします。

    • インストール先パス例 (Windows): C:\Users\<UserName>\Documents\PowerShell\Modules
    • このスコープでインストールする場合、通常管理者権限は不要です。
    • 個人用のモジュールや、他のユーザーに影響を与えたくない場合に適しています。
    • デフォルトのスコープです。Install-Module -Name MyModuleは、-Scope CurrentUserを指定したのと同じ挙動になります。

  2. AllUsers: コンピュータ上の全てのユーザーが利用できる場所にモジュールをインストールします。

    • インストール先パス例 (Windows): C:\Program Files\PowerShell\Modules または C:\Program Files (x86)\PowerShell\Modules
    • このスコープでインストールする場合、管理者権限が必要です。管理者権限を持たないユーザーがAllUsersスコープを指定してインストールしようとすると、エラーになります。
    • サーバーや共有環境で、複数のユーザーが共通して利用するモジュールをインストールする場合に適しています。

スコープを明示的に指定する場合は、-Scopeパラメータを使用します。

“`powershell

現在のユーザーのみが利用できるようにインストール (管理者権限不要)

Install-Module -Name PSScriptAnalyzer -Scope CurrentUser

コンピュータ上の全てのユーザーが利用できるようにインストール (管理者権限必要)

Install-Module -Name Az -Scope AllUsers
“`

どちらのスコープにインストールされたかを確認するには、Get-InstalledModuleコマンドレットの出力でInstalledLocationプロパティを見ます（後述）。

インストールするバージョンを指定する

Find-Moduleと同様に、Install-Moduleでもインストールしたいモジュールのバージョンを具体的に指定できます。デフォルトは最新バージョンです。

“`powershell

特定のバージョンをインストール

Install-Module -Name AzureAD -RequiredVersion 2.0.2.151

特定の最小バージョン以降の最新版をインストール

Install-Module -Name AzureAD -MinimumVersion 2.0.0
“`

-RequiredVersionは指定したバージョンそのものをインストールします。-MinimumVersionは指定したバージョン以上で利用可能な最新版をインストールします。-MaximumVersionと組み合わせて、バージョンの範囲を指定することも可能です。

古いバージョンをインストールしたい場合は、事前にFind-Module -AllVersionsで利用可能なバージョンを確認しておくと良いでしょう。

依存関係の解決

ほとんどの場合、Install-Moduleはインストールしようとしているモジュールが依存している他のモジュールを自動的に識別し、一緒にインストールしてくれます。例えば、Azモジュールは、Azureの各サービスに対応した多くのサブモジュール (Az.Accounts, Az.Compute, Az.Networkなど) に依存しています。Install-Module -Name Azを実行すると、これらの依存関係にあるサブモジュールも全て自動的にダウンロードされ、インストールされます。

依存関係を事前に確認したい場合は、Find-Module -Name <ModuleName> -IncludeDependenciesを使用します。

この自動解決機能により、ユーザーは個々の依存モジュールを手動で探してインストールする手間が省けます。

未信頼リポジトリからのインストール

PowerShell Gallery (PSGallery) は、デフォルトで「未信頼 (Untrusted)」リポジトリとして登録されています。これは、Galleryに公開されているモジュールが必ずしもMicrosoftによって厳密なコードレビューを受けているわけではないためです。初めてPSGalleryからモジュールをインストールしようとすると、以下のような警告が表示されます。

“`
未信頼リポジトリ

指定したリポジトリ ‘PSGallery’ のモジュールをインストールしようとしています。このリポジトリを信頼しますか? リポジトリを信頼するまで、未信頼リポジトリからモジュールをインストールできません。

詳細については、Get-Help about_PackageManagement を参照してください。

[Y] はい(Y) [A] すべてはい(A) [N] いいえ(N) [L] すべていいえ(L) [S] 中断(S) [?] ヘルプ (既定値は “N”):
“`

この警告は、そのリポジトリからダウンロードされるコードを実行するリスクについてユーザーに注意を促すためのものです。

  • Y (はい): このモジュールのみ、PSGalleryからのインストールを許可します。次回別のモジュールをインストールしようとすると、再びこのプロンプトが表示されます。
  • A (すべてはい): PSGalleryリポジトリ全体を信頼済みとしてマークし、以降PSGalleryからのインストール時にこのプロンプトが表示されなくなります。これが最も一般的な選択肢です。
  • N (いいえ): このモジュールのインストールをキャンセルします。
  • L (すべていいえ): PSGalleryリポジトリ全体を未信頼のままにして、以降もプロンプトを表示します。
  • S (中断): コマンドの実行を中断します。

PSGalleryを信頼済みに設定する:

毎回プロンプトが表示されるのを避けたい、かつPSGalleryを信頼できるソースと判断する場合は、Set-PSRepositoryコマンドレットを使用してインストールポリシーをTrustedに変更します。

powershell
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

このコマンドを実行すると、以降PSGalleryからのモジュールインストール時に警告が表示されなくなります。ただし、これはPSGallery上の全てのモジュールを無条件に信頼することを意味するため、十分に理解した上で行ってください。

プロンプトを表示せずにインストールを続行する (-Force):

警告プロンプトを一時的に回避し、確認なしにインストールを続行したい場合は、-Forceパラメータを使用できます。

powershell
Install-Module -Name AzureAD -Force

-Forceパラメータは、未信頼リポジトリのプロンプトを抑制するだけでなく、既存のモジュールや競合するコマンドレットがある場合にも、通常表示される警告やエラーを抑制し、インストールを強制実行する効果があります。

注意: -Forceパラメータの使用は、意図しない上書きやセキュリティリスクを招く可能性があるため、何が起こるかを正確に理解している場合にのみ使用してください。特に未信頼リポジトリからのインストールに-Forceを使用することは、警告の意味を無視することになるため推奨されません。基本的にはプロンプトに答えるか、事前にSet-PSRepositoryでポリシーを設定する方が安全です。

既存のモジュールの上書き (-AllowClobber, -Force)

既に同じ名前のコマンドレットを含むモジュールがインストールされている場合、またはインストールしようとしているモジュールが、既に読み込まれているコマンドレットと同じ名前のコマンドレットを含んでいる場合、「コマンドレット名の競合 (command name clobbering)」に関する警告やエラーが発生することがあります。

警告: コマンド 'Connect-AzureAD' は既に存在します。新しいモジュール 'AzureAD' からのコマンドは、それらが読み込まれると、既存のコマンドを上書きします。

これは警告であり、通常はインストール自体は続行されます。しかし、モジュールによってはエラーでインストールが停止する場合もあります。

このような名前の競合が発生してもインストールを続行させたい場合は、-AllowClobberパラメータを使用します。

powershell
Install-Module -Name MyNewModule -AllowClobber

-AllowClobberは、新しくインストールされるモジュールに含まれるコマンドレットが、既存のコマンドレットを上書きすることを許可します。これは、古いバージョンのモジュールを手動でアンインストールせずに新しいバージョンをインストールする際などに便利ですが、意図しないコマンドレットの上書きはスクリプトの予期せぬ動作を引き起こす可能性があるため、慎重に使用する必要があります。

また、前述の-Forceパラメータも、未信頼リポジトリのプロンプト抑制に加えて、-AllowClobberと同様に名前の競合を許可する効果があります。-Forceはより広範な警告やエラーを抑制するため、名前の競合のみを許可したい場合は-AllowClobberの方が意図が明確になります。

オフライン環境へのインストール (Save-Module と手動コピー/登録)

インターネットに接続されていない環境や、セキュリティ上の理由で直接インターネットからダウンロードしたくない環境にモジュールをインストールしたい場合もあります。このようなシナリオでは、インターネット接続がある別の環境でモジュールをダウンロードし、それをオフライン環境に持ち込んでインストールするという手順を取ります。

このダウンロードの手順に使用するのが Save-Module コマンドレットです。Save-Moduleは、指定したモジュールをPowerShell Galleryからダウンロードし、指定したローカルフォルダに保存します。Install-Moduleとは異なり、モジュールパスへの配置や登録は行いません。

Save-Module の使い方:

“`powershell

モジュールと依存関係を指定フォルダに保存

Save-Module -Name AzureAD -Path C:\Temp\SavedModules -IncludeDependencies
“`

  • -Name: 保存したいモジュール名を指定します。
  • -Path: モジュールを保存するローカルフォルダのパスを指定します。指定したフォルダが存在しない場合は作成されます。
  • -IncludeDependencies: 指定したモジュールが依存している他のモジュールも全て一緒にダウンロードして保存する場合に必須です。オフライン環境でのインストールを目的とする場合は、必ずこのパラメータを含めてください。
  • -RequiredVersion, -MinimumVersion, -MaximumVersion: 保存するモジュールのバージョンを指定できます。

Save-Moduleを実行すると、指定した-Pathの下に、モジュール名ごとのフォルダとバージョン番号ごとのフォルダが作成され、その中にモジュールのファイル群が保存されます。例えば、上記の例では C:\Temp\SavedModules\AzureAD\2.0.2.151 のようなフォルダ構造が作成されます。

オフライン環境でのインストール方法:

Save-Moduleで保存したモジュールをオフライン環境で使用するには、いくつかの方法があります。

  1. モジュールパス ($env:PSModulePath) へのコピー:
    最も簡単な方法は、保存したモジュールフォルダ全体（例: C:\Temp\SavedModules\AzureAD\2.0.2.151）を、オフライン環境のPowerShellモジュールパスの一つにコピーすることです。

    • 現在のユーザー用パス: $HOME\Documents\PowerShell\Modules
    • システム全体用パス: $env:ProgramFiles\PowerShell\Modules または $env:ProgramFiles(x86)\PowerShell\Modules
      保存したフォルダ構造を維持したまま、適切なモジュールパスの下にコピーしてください。コピー後、新しいPowerShellセッションを開くか、Import-Module -Name <ModuleName>を実行すれば、PowerShellがモジュールを認識し、使用できるようになります。

  2. ローカルフォルダをリポジトリとして登録:
    Save-Moduleでモジュールを保存したローカルフォルダ (C:\Temp\SavedModules) を、オフライン環境のPowerShellにローカルリポジトリとして登録し、そこからInstall-Moduleを実行する方法です。

    • ローカルリポジトリの登録: Register-PSRepository -Name LocalRepo -SourceLocation C:\Temp\SavedModules -InstallationPolicy Trusted
    • ローカルリポジトリからのインストール: Install-Module -Name AzureAD -Repository LocalRepo
      この方法の利点は、Install-Moduleの通常のワークフロー（依存関係の確認など）を利用できる点です。ただし、保存したモジュールが依存しているモジュールも全て-IncludeDependenciesで保存しておく必要があります。

どちらの方法を選ぶかは状況によりますが、単純にモジュールを使いたいだけであれば、モジュールパスへのコピーが手軽です。複数のモジュールを管理したり、Install-Moduleの機能を活用したい場合は、ローカルリポジトリの登録が適しています。

その他のインストールオプション

  • -Credential: 認証が必要なプライベートリポジトリからインストールする場合に使用します。
  • -Proxy, -ProxyCredential: プロキシサーバー経由でインターネットに接続する場合に必要です。
  • -Confirm, -WhatIf: インストールを実行する前に確認を求めたり、実行せずに何が起こるかを表示したりします。本番環境で重要なモジュールをインストールする前などに利用すると安全です。

powershell
Install-Module -Name MyCriticalModule -Scope AllUsers -WhatIf

このコマンドは、MyCriticalModuleをAllUsersスコープにインストールした場合に何が起こるかを表示しますが、実際にはインストールを実行しません。

インストールされたモジュールの管理

モジュールをインストールした後、現在どのようなモジュールがインストールされているかを確認したり、不要になったモジュールをアンインストールしたり、新しいバージョンに更新したりする必要が出てきます。

インストール済みモジュールの確認 (Get-InstalledModule)

現在、自分の環境にインストールされているPowerShellモジュールをリストするには、Get-InstalledModuleコマンドレットを使用します。

powershell
Get-InstalledModule

このコマンドは、デフォルトで-Scope CurrentUser, AllUsersを指定した場合と同じように、現在のユーザーとシステム全体のモジュールパスにインストールされている全てのモジュールを表示します。

出力例：

Version Name Repository Description
------- ---- ---------- -----------
2.0.2.151 AzureAD PSGallery Azure Active Directory V2 General Release Module
2.0.0 Az.Accounts PSGallery Provides cmdlets to sign in and out of Azure contro...
1.0.0 Pester PSGallery Pester is a BDD style testing and mocking framework ...
2.1.0 PSScriptAnalyzer PSGallery PSScriptAnalyzer is a static code checker for PowerS...

Find-Moduleと同様に、このコマンドの出力もモジュールの名前、バージョン、インストール元リポジトリ、説明などを含んでいます。

特定のモジュールを検索:

特定のモジュールがインストールされているか確認したい場合は、-Nameパラメータを使用します。

powershell
Get-InstalledModule -Name AzureAD

ワイルドカードも使用可能です。

powershell
Get-InstalledModule -Name *Azure*

特定のスコープで絞り込み:

特定のスコープ（CurrentUserまたはAllUsers）にインストールされているモジュールのみを表示したい場合は、-Scopeパラメータを使用します。

“`powershell

現在のユーザーにインストールされているモジュールのみ表示

Get-InstalledModule -Scope CurrentUser

システム全体にインストールされているモジュールのみ表示

Get-InstalledModule -Scope AllUsers
“`

詳細情報の表示:

インストールされているモジュールの詳細情報を確認するには、Format-Listにパイプします。

powershell
Get-InstalledModule -Name AzureAD | Format-List *

これにより、インストールされているモジュールの正確なパス（InstalledLocationプロパティ）、公開者、ライセンス情報、含まれるコマンドレットなどが確認できます。

インストール済みモジュールのアンインストール (Uninstall-Module)

不要になったモジュールを削除するには、Uninstall-Moduleコマンドレットを使用します。

powershell
Uninstall-Module -Name AzureAD

このコマンドは、指定したモジュール（デフォルトでは最新バージョン）を、インストール元のスコープからアンインストールします。

特定のバージョンをアンインストール:

特定のバージョンのみをアンインストールしたい場合は、-RequiredVersionパラメータを指定します。

powershell
Uninstall-Module -Name AzureAD -RequiredVersion 2.0.2.150

スコープを指定してアンインストール:

Install-Moduleと同様に、Uninstall-Moduleもデフォルトではモジュールがインストールされたスコープから削除しようとしますが、明示的に-Scopeを指定することも可能です。

“`powershell

現在のユーザーからモジュールをアンインストール

Uninstall-Module -Name MyModule -Scope CurrentUser

システム全体からモジュールをアンインストール (管理者権限が必要)

Uninstall-Module -Name MyModule -Scope AllUsers
“`

AllUsersスコープからアンインストールするには、通常管理者権限が必要です。

依存関係のアンインストール:

Uninstall-Moduleは、指定したモジュール自体は削除しますが、そのモジュールが依存していた他のモジュールを自動的にアンインストールしません。これは、他のインストール済みモジュールが同じ依存モジュールを使用している可能性があるためです。

依存モジュールも削除したい場合は、Get-InstalledModuleで依存関係を確認し、個別にUninstall-Moduleを実行する必要があります。

“`powershell

例: AzureAD モジュールとその依存関係を調べる

Get-InstalledModule -Name AzureAD -IncludeDependencies | Select-Object Name, Version, Dependencies

依存モジュールが不要であることを確認したら、個別にアンインストール

Uninstall-Module -Name AzureAD.Standard.Preview

“`

使用中のモジュールのアンインストール:

現在アクティブなPowerShellセッションで使用されている（インポートされている）モジュールは、通常アンインストールできません。アンインストールを実行しようとすると、エラーが表示されます。

Uninstall-Module: 指定されたモジュール 'AzureAD' は現在使用されているため、アンインストールできません。

モジュールをアンインストールするには、まずそのモジュールを使用している全てのPowerShellセッション（やプロセス）を閉じる必要があります。PowerShell Integrated Scripting Environment (ISE) や VS Code などのエディタでスクリプトを実行中の場合も注意が必要です。

どうしてもセッションを閉じずにアンインストールしたい場合は、-Forceパラメータを試すことも可能ですが、これは推奨されません。ファイルがロックされているなどの理由で失敗する可能性が高く、たとえ成功しても不安定な状態になる可能性があります。

“`powershell

非推奨！使用中のモジュールのアンインストールを強制 (失敗する可能性大)

Uninstall-Module -Name AzureAD -Force

“`

安全な方法は、PowerShellセッションを再起動することです。

インストール済みモジュールの更新 (Update-Module)

インストール済みのモジュールに新しいバージョンが公開されている場合、Update-Moduleコマンドレットを使用して簡単に更新できます。

“`powershell

特定のモジュールを最新版に更新

Update-Module -Name AzureAD
“`

このコマンドは、インストールされているAzureADモジュールを検索し、PSGalleryにある最新バージョンと比較します。もし新しいバージョンがあれば、それをダウンロードして既存のバージョンを置き換えます（古いバージョンは削除されます）。

全てのモジュールを更新:

インストールされている全てのモジュールに対して更新を確認し、利用可能なものは全て更新したい場合は、-Nameパラメータを省略します。

powershell
Update-Module

このコマンドは、Get-InstalledModuleでリストされる全てのモジュールについて更新を確認し、利用可能なものは全て更新します。

特定のスコープのモジュールを更新:

Update-Moduleも、デフォルトではCurrentUserとAllUsers両方のスコープを対象とします。特定のスコープのモジュールのみを更新したい場合は、-Scopeパラメータを使用します。

“`powershell

現在のユーザーにインストールされているモジュールのみ更新

Update-Module -Scope CurrentUser

システム全体にインストールされているモジュールのみ更新 (管理者権限が必要)

Update-Module -Scope AllUsers
“`

AllUsersスコープのモジュールを更新するには、通常管理者権限が必要です。

プレリリース版への更新:

デフォルトでは、Update-Moduleは安定版の最新バージョンのみを考慮します。プレリリース版（ベータ版やRC版など）に更新したい場合は、-AllowPrereleaseパラメータを使用します。

powershell
Update-Module -Name AzureAD -AllowPrerelease

使用中のモジュールの更新:

Update-Moduleも、Uninstall-Moduleと同様に、現在使用中のモジュールを更新しようとすると問題が発生する可能性があります。多くの場合、更新は成功しますが、新しいバージョンは次のPowerShellセッションを開始するまで反映されません。場合によってはエラーが発生することもあります。

更新を確実に反映させるためには、モジュールを使用している全てのPowerShellセッションを閉じてからUpdate-Moduleを実行し、その後新しいセッションを開始するのが最も確実な方法です。

更新後の確認:

モジュールを更新した後、Get-InstalledModule -Name <ModuleName>を実行して、バージョンが期待通りに更新されたことを確認しましょう。

PowerShellがモジュールを見つける仕組み ($env:PSModulePath)

インストールされたモジュールがどのようにPowerShellによって認識されるのかを理解することは、モジュール管理の助けになります。PowerShellは、$env:PSModulePathという環境変数に定義されているパスを検索してモジュールを見つけます。

$env:PSModulePathを確認してみましょう。

powershell
$env:PSModulePath -split ';'

出力例 (Windowsの場合):

C:\Users\<UserName>\Documents\PowerShell\Modules
C:\Program Files\PowerShell\Modules
C:\Program Files\WindowsPowerShell\Modules
C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules

この例では、複数のパスがセミコロン(;)で区切られてリストされています。PowerShellは、モジュールをインポートしたり、自動的にロードしようとしたりする際に、これらのパスを順番に検索します。

  • C:\Users\<UserName>\Documents\PowerShell\Modules: これがデフォルトのCurrentUserスコープのインストール先です。
  • C:\Program Files\PowerShell\Modules (PowerShell 7+) または C:\Program Files\WindowsPowerShell\Modules (Windows PowerShell 5.1): これらがデフォルトのAllUsersスコープのインストール先です。
  • C:\WINDOWS\system32\...: これはPowerShellに標準で付属するコアモジュールなどが配置されている場所です。

Install-Module -Scope CurrentUserでインストールされたモジュールは、$HOME\Documents\PowerShell\Modules (これはC:\Users\<UserName>\Documents\PowerShell\Modulesを指します) の下に配置されます。
Install-Module -Scope AllUsersでインストールされたモジュールは、$env:ProgramFiles\PowerShell\Modules または $env:ProgramFiles(x86)\PowerShell\Modules の下に配置されます（PowerShellのバージョンやアーキテクチャによってパスが異なります）。

PowerShellは、これらのパスの下にあるフォルダを探し、各フォルダがモジュールフォルダとして認識できる構造になっているかを確認します（通常、モジュールマニフェストファイル(.psd1)やモジュールファイル(.psm1, .psm1d, .dll)が含まれているかなど）。

Save-Moduleでローカルに保存したモジュールを$env:PSModulePathに含まれるフォルダにコピーすれば、PowerShellがそのモジュールを自動的に見つけられるようになります。

複数のバージョンが存在する場合のモジュールのロード

$env:PSModulePath内の同じ名前のモジュールフォルダ内に複数のバージョンフォルダが存在する場合（例: ...\Modules\MyModule\1.0.0 と ...\Modules\MyModule\2.0.0）、PowerShellはデフォルトで最新バージョンをロードしようとします。

特定のバージョンを明示的にインポートしたい場合は、Import-Moduleコマンドレットの-RequiredVersionパラメータを使用します。

powershell
Import-Module -Name MyModule -RequiredVersion 1.0.0

これは、インストール済みのモジュールに対してのみ有効です。Install-Moduleは、異なるスコープに同じ名前のモジュールが存在する場合、デフォルトではスコープの優先順位（CurrentUser > AllUsers）に従ってインストール先を決定し、通常は同じスコープ内に複数のバージョンを共存させます（ただし、特定のバージョン指定なしでのインストールは最新版が優先されるため、古いバージョンが置き換えられる場合もあります）。

リポジトリの管理

PowerShell Gallery (PSGallery) 以外にも、プライベートなNuGetフィードやファイル共有フォルダなどをPowerShellのモジュールリポジトリとして登録し、Find-ModuleやInstall-Moduleの対象とすることができます。

登録されているリポジトリの確認 (Get-PSRepository)

現在PowerShellに登録されているリポジトリを確認するには、Get-PSRepositoryコマンドレットを使用します。

powershell
Get-PSRepository

出力例：

Name SourceLocation InstallationPolicy
---- -------------- ------------------
PSGallery https://www.powershellgallery.com/api/v2 Untrusted
MyInternalRepo \\fileshare\repo Trusted

このコマンドは、登録されているリポジトリの名前 (Name)、モジュールの取得元URLまたはパス (SourceLocation)、そしてインストールポリシー (InstallationPolicy) を表示します。インストールポリシーは、そのリポジトリからモジュールをインストールする際に警告を表示するかどうかを制御します。

新しいリポジトリの登録 (Register-PSRepository)

プライベートなモジュールリポジトリなどをPowerShellに登録するには、Register-PSRepositoryコマンドレットを使用します。

“`powershell

NuGetフィードを登録する例

Register-PSRepository -Name MyInternalNuGetFeed -SourceLocation https://mynugetserver/nuget/v2 -InstallationPolicy Trusted

ファイル共有フォルダを登録する例

Register-PSRepository -Name MyLocalFileShare -SourceLocation \fileserver\ModulesRepo -InstallationPolicy Trusted
“`

  • -Name: リポジトリに付けるユニークな名前です。Find-ModuleやInstall-Moduleの-Repositoryパラメータでこの名前を指定します。
  • -SourceLocation: リポジトリのURLまたはローカルパスです。NuGetフィードやファイル共有など、サポートされている形式で指定します。
  • -InstallationPolicy: このリポジトリからモジュールをインストールする際のポリシーを指定します。TrustedまたはUntrustedを設定できます。内部の信頼できるソースであればTrustedを設定するのが一般的です。

Register-PSRepositoryを実行するには、通常管理者権限が必要です。

リポジトリの削除 (Unregister-PSRepository)

不要になったリポジトリの登録を削除するには、Unregister-PSRepositoryコマンドレットを使用します。

powershell
Unregister-PSRepository -Name MyInternalNuGetFeed

このコマンドは、指定した名前のリポジトリ登録を解除しますが、実際にそのリポジトリのコンテンツ（モジュールファイルなど）が削除されるわけではありません。単にPowerShellからそのリポジトリへのアクセス設定が削除されるだけです。

このコマンドを実行するには、通常管理者権限が必要です。

リポジトリの優先順位

複数のリポジトリが登録されている場合、Find-ModuleやInstall-Moduleがモジュールを検索する際の優先順位は、Get-PSRepositoryコマンドレットで表示されるリストの順序によって決まります。リストの上にあるリポジトリほど優先されます。

デフォルトでは、PSGalleryが最も優先順位が高くなるように登録されます。リポジトリの優先順位を変更したい場合は、Get-PSRepositoryの出力を並べ替えて、Set-PSRepositoryコマンドレット（PowerShellGet v2.0.0以降で利用可能）の-Priorityパラメータを使用します。ただし、通常はこの設定を変更する必要はありません。

セキュリティに関する考慮事項

PowerShell Galleryは便利なリソースですが、インターネットからコードをダウンロードして実行することには常にセキュリティ上のリスクが伴います。以下の点に注意が必要です。

  1. 未信頼リポジトリの警告: 前述の通り、PowerShell Galleryはデフォルトで未信頼と見なされます。この警告は、モジュールをインストールする前に、そのソースを信頼できるかよく考えるように促す重要なセキュリティ機能です。Set-PSRepository -InstallationPolicy Trustedを実行する前に、PSGalleryが自身のセキュリティ基準を満たしているか検討してください。多くのユーザーにとってPSGalleryを信頼済みにすることは問題ありませんが、企業のセキュリティポリシーによっては制限がある場合もあります。
  2. モジュールの発行元: PSGalleryには、Microsoftだけでなく、様々な個人や組織がモジュールを公開しています。Find-Moduleの詳細情報 (Format-List) で表示されるAuthorやCompanyNameを確認し、信頼できる発行元からのモジュールを選択することが重要です。有名なベンダー（Microsoft, VMware, AWSなど）や、活発なコミュニティプロジェクトのモジュールは比較的信頼性が高い傾向があります。
  3. モジュールの内容: 公開されているモジュールの中には、悪意のあるコードが含まれている可能性もゼロではありません。特に、機密性の高い情報を扱うシステムで利用するモジュールや、あまり知られていない発行元によるモジュールをインストールする際は、注意が必要です。可能であれば、モジュールのスクリプトコードを簡単にレビューしたり、サンドボックス環境で試したりすることを検討してください。
  4. コード署名: 信頼できる発行元によってデジタル署名されたモジュールは、改ざんされていないことの保証が得られます。Find-ModuleやGet-InstalledModuleの詳細情報で署名に関するプロパティを確認したり、Get-AuthenticodeSignatureコマンドレットを使用してモジュールファイルの署名を確認したりできます。署名があるモジュールは、そうでないモジュールよりも信頼性が高いと考えられます。
  5. 最小限の権限: モジュールをインストールする際は、必要最小限の権限で実行することを心がけましょう。CurrentUserスコープへのインストールは管理者権限が不要なため、可能な場合はCurrentUserスコープを選択するのが安全です。
  6. 定期的な更新: モジュールには、セキュリティ上の脆弱性が含まれている可能性があります。発行元は通常、そのような問題を修正した新しいバージョンを公開します。Update-Moduleを定期的に実行し、モジュールを最新の状態に保つことは、セキュリティリスクを低減するために重要です。

よくある問題とトラブルシューティング

PowerShell Galleryからのモジュール検索やインストール中に発生しうる一般的な問題と、その解決策をいくつか紹介します。

  1. モジュールが見つからない (Find-Moduleで結果が表示されない):

    • モジュール名のスペルミス: 最も単純な原因です。モジュール名やキーワードを正確に入力しているか確認してください。ワイルドカード(*)を使用してみるのも有効です。
    • リポジトリの指定ミス: 目的のモジュールがデフォルトのPSGallery以外のリポジトリにある場合、-Repositoryパラメータで正しいリポジトリ名を指定する必要があります。Get-PSRepositoryで登録済みリポジトリを確認してください。
    • PowerShellGetモジュールのバージョンが古い: PowerShellGetモジュールが古い場合、ギャラリーとの通信に問題が発生することがあります。Install-Module PowerShellGet -Force -AllowClobberでPowerShellGetモジュール自体を最新版に更新してみてください（要管理者権限）。
    • インターネット接続またはプロキシの問題: PowerShellがインターネットに接続できていない可能性があります。ウェブブラウザでwww.powershellgallery.comにアクセスできるか確認してください。プロキシ環境の場合は、PowerShellのプロキシ設定が正しく行われているか確認してください。
    • ファイアウォールによるブロック: ファイアウォールがPowerShellまたは使用しているポートからのGalleryへのアクセスをブロックしている可能性があります。必要なURL (https://www.powershellgallery.com) およびポートが開いているかネットワーク管理者に確認してください。

  2. インストールに失敗する (Install-Moduleがエラーになる):

    • 権限の問題: AllUsersスコープにインストールしようとしているのに管理者権限がない場合、エラーになります。管理者としてPowerShellセッションを開くか、-Scope CurrentUserに変更してください。
    • モジュールが使用中: アンインストールや更新のセクションで述べたように、使用中のモジュールは通常操作できません。関連するPowerShellセッションやプロセスを全て閉じてから再度試してください。
    • 依存関係の問題: Install-Moduleは依存関係を自動解決しますが、稀に特定の環境で解決に失敗したり、依存モジュール自体が入手できなかったりする場合があります。エラーメッセージの詳細を確認してください。
    • ネットワークの問題: ダウンロード中にネットワーク接続が不安定になったり切断されたりすると、インストールが失敗します。ネットワーク状態を確認し、再度試してください。
    • ストレージ容量不足: インストール先に十分なディスク容量があるか確認してください。
    • ファイルロック: 他のプロセスがインストール先フォルダ内のファイルをロックしている可能性があります。PCを再起動してから再度試すのが最も簡単な解決策です。
    • 未信頼リポジトリプロンプトに応答しなかった/-Forceなしで続行した: 警告プロンプトが表示された際にNまたはLを選択したか、何も応答せずにタイムアウトした場合、インストールは中止されます。プロンプトに適切に応答するか、事前にリポジトリを信頼済みに設定してください。
    • PowerShellのバージョン要件: モジュールが特定のPowerShellバージョン以上を要求している場合、現在のPowerShellバージョンが古いとインストールできないことがあります。モジュールの詳細情報 (Find-Module | Format-List) でPowerShellVersionプロパティを確認し、必要に応じてPowerShellを更新してください。

  3. インストールは成功したが、モジュールをインポートできない、コマンドレットが認識されない:

    • PowerShellセッションの再起動: モジュールをインストールまたは更新した後、新しいPowerShellセッションを開かないと、変更が反映されないことがあります。PowerShellウィンドウを一度閉じてから開き直してください。
    • $env:PSModulePathに含まれていない場所にインストールした: Save-Moduleでダウンロードしたモジュールを、PowerShellが検索しない場所にコピーした場合などです。モジュールフォルダを適切な$env:PSModulePathにコピーするか、Import-Module -Path <モジュールフォルダのパス>で明示的にインポートしてください。
    • 実行ポリシーによるブロック: モジュール自体はインストールできても、その中のスクリプトやコマンドレットがPowerShellの実行ポリシーによって実行をブロックされている可能性があります。特にインターネットからダウンロードしたスクリプトの実行を許可しないポリシー設定の場合に起こりえます。Get-ExecutionPolicyで確認し、必要に応じて変更してください。ただし、実行ポリシーの変更はセキュリティリスクを伴うため、慎重に行ってください。
    • モジュールが正常にインストールされなかった: 何らかの原因でインストールプロセスが途中で失敗し、モジュールファイルが不完全な状態になっている可能性があります。一度モジュールをアンインストールしてから、再度インストールを試みてください。

トラブルシューティングの際は、表示されるエラーメッセージを注意深く読み、それに基づいて原因を特定することが重要です。エラーメッセージには、問題解決の手がかりとなる情報（ファイルパス、権限、特定のオブジェクト名など）が含まれていることがよくあります。

まとめと次のステップ

この記事では、PowerShell Galleryの基本的な概念から、モジュールの検索 (Find-Module)、インストール (Install-Module)、保存 (Save-Module)、およびインストール済みモジュールの管理 (Get-InstalledModule, Uninstall-Module, Update-Module) について、様々なオプションやパラメータを含めて詳細に解説しました。また、リポジトリの管理やセキュリティ上の考慮事項、よくあるトラブルシューティングについても触れました。

PowerShell Galleryは、PowerShellユーザーにとって非常に強力なツールです。これにより、世界中の開発者やコミュニティが作成した便利な機能を簡単に自分の環境に取り込むことができます。特定の管理タスクを自動化したい場合、まずPowerShell Galleryで関連するモジュールが公開されていないか探してみるのが良いプラクティスです。

この記事で学んだ知識を活用して、ぜひPowerShell Galleryを積極的に利用し、PowerShellによるシステム管理や自動化をさらに効率的かつ強力に進めてください。

次のステップとして考えられること:

  • 様々なモジュールを試してみる: Microsoft Graph、Azure、AWS、VMware、Active Directory、SQL Serverなど、自分の興味のある分野や業務に関連するモジュールをPSGalleryで検索し、インストールして使ってみましょう。
  • モジュールのドキュメントを読む: インストールしたモジュールに含まれるコマンドレットの使い方や詳細な機能を知るには、モジュールのドキュメントを読むことが不可欠です。Get-Command -Module <ModuleName>でモジュールに含まれるコマンドレットをリストし、Get-Help <CmdletName> -FullやGet-Help <CmdletName> -Examplesで各コマンドレットのヘルプを参照しましょう。多くのモジュールのPSGalleryページには、プロジェクトサイトやドキュメントへのリンクが掲載されています。
  • 独自のモジュールを作成・公開してみる: 独自のPowerShell関数やスクリプトを作成する機会があれば、それらをモジュールとしてパッケージ化し、Publish-Moduleコマンドレットを使ってPowerShell Galleryに公開することを検討してみましょう。これはコミュニティへの貢献にも繋がります。
  • PowerShellGetモジュールの高度な機能を探求する: PowerShellGetモジュールには、モジュールの開発、テスト、公開に関するさらに多くのコマンドレットや機能があります。

PowerShell Galleryの活用は、PowerShellのスキルアップと生産性向上に直結します。この記事が、その第一歩を踏み出すための手助けとなれば幸いです。

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール