Save-Module
モジュールとその依存関係をローカル コンピューターに保存しますが、モジュールはインストールしません。
構文
Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-InputObject] <PSObject[]>
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Save-Module
[-InputObject] <PSObject[]>
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
Save-Module コマンドレットは、登録済みのリポジトリからモジュールと依存関係をダウンロードします。
Save-Module モジュールの最新バージョンをダウンロードして保存します。 ファイルは、ローカル コンピューター上の指定したパスに保存されます。 モジュールはインストールされていませんが、内容は管理者が検査できます。 保存されたモジュールは、オフライン コンピューターの適切な $env:PSModulePath の場所にコピーできます。
これは、Microsoft.PowerShell.PSResourceGet のSave-PSResource コマンドレットのプロキシ コマンドレットです。 詳細については、「Save-PSResource」を参照してください。
例
例 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
Save-Module では、 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
Save-Module では、 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
Find-Module では、 Name パラメーターを使用してモジュール PowerShellGet を指定します。
Repository パラメーターは、登録済みリポジトリ PSGallery を指定します。
RequiredVersion はバージョン 1.6.5 を指定します。
オブジェクトはパイプラインを Save-Moduleに送信されます。
Path パラメーターは、ダウンロードしたモジュールを格納する場所を指定します。 ダウンロードが完了すると、 Get-ChildItem ファイルが格納されている パス の内容が表示されます。
パラメーター
-AcceptLicense
プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllowPrerelease
プレリリースとしてマークされたモジュールを保存できます。
プロキシ コマンドレットは、このパラメーターを Save-PSResource のプレリリース パラメーターにマップします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
Save-Moduleを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
モジュールを保存する権限を持つユーザー アカウントを指定します。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Force
プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
PSRepositoryItemInfo オブジェクトを受け入れます。 たとえば、出力は変数に Find-Module し、その変数を InputObject 引数として使用します。
| 型: | PSObject[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LiteralPath
1 つ以上の場所へのパスを指定します。 LiteralPath パラメーターの値は、入力したとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 PowerShell では、単一引用符で囲まれた文字はエスケープ シーケンスとして解釈されません。
プロキシ コマンドレットは、このパラメーターを Save-PSResource の Path パラメーターにマップします。
| 型: | String |
| Aliases: | PSPath |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MaximumVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Save-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MinimumVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Save-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
保存するモジュールの名前の配列を指定します。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Path
保存されたモジュールを格納するローカル コンピューター上の場所を指定します。 ワイルドカード文字を受け入れます。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-Proxy
プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ProxyCredential
プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Repository
Register-PSRepositoryを実行して登録されたリポジトリのフレンドリ名を指定します。
Get-PSRepositoryを使用して、登録済みリポジトリを表示します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RequiredVersion
プロキシ コマンドレットは、このパラメーターの値を使用して、Save-PSResourceの Version パラメーターで使用する NuGet バージョン検索文字列を作成します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
Save-Module が実行された場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
String[]
PSObject[]
出力
メモ
PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 はサポートされなくなりました。 TLS 1.2 以降を使用する必要があります。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
