Save-Module

モジュール:: PowershellGet

モジュールとその依存関係をローカルコンピューターに保存しますが、モジュールはインストールしません。

構文

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    -Path <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Force]
    [-WhatIf]
    [-Confirm] 
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -Path <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Save-Module コマンドレットは、登録されたリポジトリからモジュールと依存関係をダウンロードします。 Save-Module は、最新バージョンのモジュールをダウンロードして保存します。ファイルは、ローカルコンピューター上の指定したパスに保存されます。モジュールはインストールされていませんが、内容は管理者が検査できます。

Get-PSRepository ローカルコンピューターの登録済みリポジトリが表示されます。 Find-Module コマンドレットを使用して、登録済みリポジトリを検索できます。

例

例 1: モジュールを保存する

この例では、モジュールとその依存関係がローカルコンピューターに保存されます。

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

では、Name パラメーターを使用して、PowerShellGetモジュールを指定します。 Path パラメーターは、ダウンロードしたモジュールを格納する場所を指定します。 Repository パラメーターは、PSGallery登録済みリポジトリを指定します。ダウンロードが完了すると、Get-ChildItem ファイルが格納されているパスの内容が表示されます。

例 2: モジュールの特定のバージョンを保存する

この例では、MaximumVersionや RequiredVersion などのパラメーターを使用してモジュールのバージョンを指定する方法を示します。

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

では、Name パラメーターを使用して、PowerShellGetモジュールを指定します。 Path パラメーターは、ダウンロードしたモジュールを格納する場所を指定します。 Repository パラメーターは、PSGallery登録済みリポジトリを指定します。 MaximumVersion は、バージョン 2.1.0 をダウンロードして保存することを指定します。ダウンロードが完了すると、Get-ChildItem ファイルが格納されているパスの内容が表示されます。

例 3: モジュールの特定のバージョンを検索して保存する

この例では、必要なモジュールバージョンがリポジトリに見つかり、ローカルコンピューターに保存されます。

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

では、Name パラメーターを使用して、PowerShellGetモジュールを指定します。 Repository パラメーターは、PSGallery登録済みリポジトリを指定します。 RequiredVersion は、バージョン 1.6.5を指定します。

オブジェクトはパイプラインを Save-Moduleに送信されます。 Path パラメーターは、ダウンロードしたモジュールを格納する場所を指定します。ダウンロードが完了すると、Get-ChildItem ファイルが格納されているパスの内容が表示されます。

パラメーター

-Confirm

Save-Moduleを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

ユーザーの確認を求めずに Save-Module を強制的に実行します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

PSRepositoryItemInfo オブジェクトを受け入れます。たとえば、出力は変数に Find-Module し、その変数を InputObject 引数として使用します。

型:	PSObject[]
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-LiteralPath

1 つ以上の場所へのパスを指定します。 LiteralPath パラメーターの値は、入力したとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 PowerShell では、単一引用符で囲まれた文字はエスケープシーケンスとして解釈されません。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MaximumVersion

保存するモジュールの最大バージョンまたは最新バージョンを指定します。 MaximumVersion パラメーターと RequiredVersion パラメーターは、同じコマンドでは使用できません。

型:	Version
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MinimumVersion

保存する 1 つのモジュールの最小バージョンを指定します。複数のモジュールをインストールしようとしている場合は、このパラメーターを追加できません。 MinimumVersion パラメーターと RequiredVersion パラメーターは、同じコマンドでは使用できません。

型:	Version
Aliases:	Version
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

保存するモジュールの名前の配列を指定します。

型:	String[]
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Path

保存されたモジュールを格納するローカルコンピューター上の場所を指定します。ワイルドカード文字を受け入れます。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-Repository

Register-PSRepositoryを実行して登録されたリポジトリのフレンドリ名を指定します。 Get-PSRepository を使用して、登録済みリポジトリを表示します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-RequiredVersion

保存するモジュールの正確なバージョン番号を指定します。

型:	Version
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

Save-Module が実行された場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False