Save-Module

モジュール:

PowerShellGet v3 Module

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

構文

NameAndPathParameterSet (既定)

Save-Module
    [-Name] <String[]>
    [-Path] <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameAndLiteralPathParameterSet

Save-Module
    [-Name] <String[]>
    -LiteralPath <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndLiteralPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

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

これは、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

では、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 ファイルが格納されている パス の内容が表示されます。

パラメーター

-AcceptLicense

プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-AllowPrerelease

プレリリースとしてマークされたモジュールを保存できます。

プロキシ コマンドレットは、このパラメーターを のSave-PSResource パラメーターにマップします。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

NameAndPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

NameAndLiteralPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Confirm

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

パラメーターのプロパティ

型:	SwitchParameter
規定値:	False
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	cf

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Credential

モジュールを保存する権限を持つユーザー アカウントを指定します。

パラメーターのプロパティ

型:	PSCredential
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-Force

プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-InputObject

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 では、単一引用符で囲まれた文字はエスケープ シーケンスとして解釈されません。

プロキシ コマンドレットは、このパラメーターを の Save-PSResource パラメーターにマップします。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	PSPath

パラメーター セット

NameAndLiteralPathParameterSet

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

InputObjectAndLiteralPathParameterSet

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-MaximumVersion

プロキシ コマンドレットは、このパラメーターの値を使用して、の Save-PSResource パラメーターで使用する NuGet バージョン検索文字列を作成します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

NameAndPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

NameAndLiteralPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-MinimumVersion

プロキシ コマンドレットは、このパラメーターの値を使用して、の Save-PSResource パラメーターで使用する NuGet バージョン検索文字列を作成します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

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
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

InputObjectAndPathParameterSet

配置:	1
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-Proxy

プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。

パラメーターのプロパティ

型:	Uri
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-ProxyCredential

プロキシ コマンドレットは、 Save-PSResourceでサポートされていないため、このパラメーターを無視します。

パラメーターのプロパティ

型:	PSCredential
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-Repository

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

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

NameAndPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

NameAndLiteralPathParameterSet

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-RequiredVersion

プロキシ コマンドレットは、このパラメーターの値を使用して、の Save-PSResource パラメーターで使用する NuGet バージョン検索文字列を作成します。

パラメーターのプロパティ

型:	String
規定値:	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を参照してください。

入力

String

PSObject

String

Uri

PSCredential

出力

Object

メモ

PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 はサポートされなくなりました。 TLS 1.2 以降を使用する必要があります。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12