Save-Module
モジュールとその依存関係をローカル コンピューターに保存しますが、モジュールはインストールしません。
構文
NameAndPathParameterSet (既定)
Save-Module
[-Name] <String[]>
-Path <String>
[-MinimumVersion <Version>]
[-MaximumVersion <Version>]
[-RequiredVersion <Version>]
[-Repository <String[]>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameAndLiteralPathParameterSet
Save-Module
[-Name] <String[]>
-LiteralPath <String>
[-MinimumVersion <Version>]
[-MaximumVersion <Version>]
[-RequiredVersion <Version>]
[-Repository <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
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずに Save-Module を強制的に実行します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
PSRepositoryItemInfo オブジェクトを受け入れます。 たとえば、出力は変数に Find-Module し、その変数を InputObject 引数として使用します。
| 型: | PSObject[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
InputObjectAndLiteralPathParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
InputObjectAndPathParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-LiteralPath
1 つ以上の場所へのパスを指定します。
LiteralPath パラメーターの値は、入力したとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 PowerShell では、単一引用符で囲まれた文字はエスケープ シーケンスとして解釈されません。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
InputObjectAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaximumVersion
保存するモジュールの最大バージョンまたは最新バージョンを指定します。
MaximumVersion パラメーターと RequiredVersion パラメーターを同じコマンドで使用することはできません。
パラメーターのプロパティ
| 型: | Version
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameAndPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
NameAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-MinimumVersion
保存する 1 つのモジュールの最小バージョンを指定します。 複数のモジュールをインストールしようとしている場合は、このパラメーターを追加できません。
MinimumVersion パラメーターと RequiredVersion パラメーターを同じコマンドで使用することはできません。
パラメーターのプロパティ
| 型: | Version
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | バージョン |
パラメーター セット
NameAndPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
NameAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
保存するモジュールの名前の配列を指定します。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameAndPathParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
NameAndLiteralPathParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Path
保存されたモジュールを格納するローカル コンピューター上の場所を指定します。 ワイルドカード文字を受け入れます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
NameAndPathParameterSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
InputObjectAndPathParameterSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Repository
Register-PSRepositoryを実行して登録されたリポジトリのフレンドリ名を指定します。
Get-PSRepository を使用して、登録済みリポジトリを表示します。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameAndPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
NameAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-RequiredVersion
保存するモジュールの正確なバージョン番号を指定します。
パラメーターのプロパティ
| 型: | Version
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameAndPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
NameAndLiteralPathParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
Save-Module が実行された場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。