Save-PSResource
登録済みリポジトリからマシンにリソース (モジュールとスクリプト) を保存します。
構文
Save-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-IncludeXml]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-IncludeXml]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、PowerShellGet v2 の Save-Module
コマンドレットと Save-Script
コマンドレットの機能を組み合わせたものです。
Save-PSResource
は、登録されたリポジトリからローカル コンピューター上の特定のパスにリソースをダウンロードします。 既定では、リソースはアンパックまたはインストールされた形式で保存されます。 スクリプトまたはモジュールは、保存された場所から実行できます。 形式でリソース .nupkg
をダウンロードするオプションもあります。
例
例 1
最も優先度の高いリポジトリから Az モジュールをダウンロードし、現在の場所に保存します。
Save-PSResource -Name Az
例 2
PowerShell ギャラリーから Az モジュールをダウンロードし、現在の場所に保存します。
Save-PSResource -Name Az -Repository PSGallery
例 3
最も優先度の高いリポジトリから Az モジュールをダウンロードし、形式で .nupkg
現在の場所に保存します。
Save-PSResource Az -AsNupkg
例 4
最も優先度の高いリポジトリから Az モジュールをダウンロードし、 PowerShellGet XML メタデータ ファイルを含めます。
Save-PSResource Az -IncludeXML
パラメーター
-AsNupkg
リソースをファイルとして .nupkg
保存します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AuthenticodeCheck
Windows 上のリソースの署名済みファイルとカタログ ファイルを検証します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
リポジトリにアクセスするときに使用されるオプションの資格情報。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IncludeXml
PowerShellGet がモジュールをインストールしたことを確認するために使用される PowerShellGet メタデータ XML が含まれています。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
パイプライン入力に使用されます。
型: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
インストールする 1 つ以上のリソースの名前。
型: | String[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PassThru
指定すると、保存されたリソースの PSResourceInfo オブジェクトが出力されます。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
リソースを保存するパスを指定します。 パスが指定されていない場合、リソースは現在のディレクトリに保存されます。
型: | String |
配置: | Named |
規定値: | current directory |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Prerelease
指定すると、返される検索結果にプレリリース バージョンが含まれます。
型: | SwitchParameter |
Aliases: | IsPrerelease |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Repository
検索する 1 つ以上のリポジトリ名を指定します。 指定しない場合、パッケージを含むリポジトリが見つかるまで、検索には、登録されているすべてのリポジトリが優先順位 (最も高い順) で含まれます。 リポジトリは優先度順に並べ替えられた後、名前で並べ替えられます。 優先度の値が低いほど優先順位が高くなります。
複数のリポジトリ間でリソースを検索する場合、 PSResourceGet コマンドレットは、この並べ替え順序を使用してリポジトリを検索します。
Save-PSResource
は、並べ替えられたリポジトリの一覧から最初に一致するパッケージを保存します。
パラメーターはワイルドカード文字を *
サポートしています。 複数のリポジトリを指定する場合は、すべての名前にワイルドカード文字を含めるか省略する必要があります。 ワイルドカードの有無にかかわらず、名前の組み合わせを指定することはできません。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-SkipDependencyCheck
リソースの依存関係のチェックをスキップします。 見つかったリソースのみがインストールされます。 見つかったリソースのリソースはインストールされていません。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TemporaryPath
保存する前にリソースを一時的にインストールするパスを指定します。 一時パスが指定されていない場合、リソースは現在のユーザーの一時フォルダーに一時的にインストールされます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TrustRepository
リポジトリを信頼するように求めるプロンプトを表示しない。 リポジトリを信頼するように求めるプロンプトは、リポジトリが信頼済みとして構成されていない場合にのみ発生します。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Version
返されるリソースのバージョンを指定します。 値には、NuGet のバージョン管理構文を使用して、正確なバージョンまたはバージョン範囲を指定できます。
NuGet のバージョン範囲の詳細については、「 パッケージのバージョン管理」を参照してください。
PowerShellGet では、NuGet のバージョン範囲に関するドキュメントに記載されている 最小包括バージョン 以外のすべてのバージョンがサポートされています。 バージョンとして を使用 1.0.0.0
しても、バージョン 1.0.0.0 以降 (最小包括範囲) は生成されません。 代わりに、値は必要なバージョンと見なされます。 最小包括範囲を検索するには、バージョン範囲として を使用 [1.0.0.0, ]
します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | True |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
出力
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
既定では、コマンドレットはオブジェクトを返しません。 PassThru パラメーターを使用すると、コマンドレットは保存されたリソースの PSResourceInfo オブジェクトを出力します。
PSResourceGet