Share via

Install-PSResource

  • リファレンス
モジュール:
Microsoft.PowerShell.PSResourceGet

登録済みリポジトリからリソースをインストールします。

構文

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

このコマンドレットは、登録済みリポジトリからマシン上のインストール パスにリソースをインストールします。 既定では、 コマンドレットはオブジェクトを返しません。 その他のパラメーターを使用すると、リソースのリポジトリ、スコープ、バージョンを指定し、ライセンス プロンプトを抑制できます。

このコマンドレットは、PowerShellGet v2 の および Install-Script コマンドレットのInstall-Module関数を組み合わせています。

例

例 1

Az モジュールの最新の安定版 (プレリリース以外) バージョンをインストールします。

Install-PSResource Az

例 2

バージョンと の間に最新の安定した Az モジュールをインストールします7.3.08.3.0。

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

例 3

Az モジュールの最新の安定バージョンをインストールします。 Reinstall パラメーターを使用すると、コマンドレットは以前にインストールしたバージョンに対して書き込みます。

Install-PSResource Az -Reinstall

例 4

psd1 ファイルで指定された PSResources をインストールします。

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

例 5

ハッシュテーブルで指定された PSResources をインストールします。

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

パラメーター

-AcceptLicense

リソースが使用許諾契約書に同意する要求を受け入れる必要があることを指定します。 これにより、モジュールがユーザーに使用許諾契約書への同意を義務付けるかどうかを確認するメッセージが表示されなくなります。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

Windows で Authenticode 署名とカタログ ファイルを検証します。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

リポジトリにアクセスするときに使用されるオプションの資格情報。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

パイプライン入力に使用されます。

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

インストールする 1 つ以上のリソースの名前。

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoClobber

コンピューターに既に存在するコマンドレットを含むパッケージをインストールできないようにします。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

指定すると、保存されたリソースの PSResourceInfo オブジェクトが出力されます。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

指定すると、返される検索結果にプレリリース バージョンが含まれます。

Type:SwitchParameter
Aliases:IsPrerelease
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Quiet

インストール進行状況バーを抑制します。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Reinstall

最新バージョンが既にインストールされている場合でも、モジュールの最新バージョンをインストールします。 インストールされているバージョンが上書きされます。 これにより、モジュールの破損したインストールを修復できます。

モジュールの古いバージョンがインストールされている場合、新しいバージョンは、新しいバージョン固有のフォルダーに並べてインストールされます。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

検索する 1 つ以上のリポジトリ名を指定します。 指定しない場合、パッケージを含むリポジトリが見つかるまで、検索には優先順位 (最も高い順) にすべての登録済みリポジトリが含まれます。 リポジトリは優先度順、名前順に並べ替えられます。 優先度の値が小さい方が優先順位が高くなります。

複数のリポジトリ間でリソースを検索する場合、 PSResourceGet コマンドレットは、この並べ替え順序を使用してリポジトリを検索します。 Install-PSResource は、並べ替えられたリポジトリの一覧から最初に一致するパッケージをインストールします。

パラメーターはワイルドカード文字を * サポートしています。 複数のリポジトリを指定する場合、すべての名前にワイルドカード文字を含めるか省略する必要があります。 ワイルドカードの有無にかかわらず、名前の組み合わせを指定することはできません。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-RequiredResource

インストールするリソースを指定するハッシュテーブルまたは JSON 文字列。 ワイルドカード文字は使用できません。 ファイル形式の説明については、「 NOTES 」セクションを参照してください。

Type:Object
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequiredResourceFile

または へのパス。.psd1.jsonインストールするリソースを指定します。 ワイルドカード文字は使用できません。 ファイル形式の説明については、「 NOTES 」セクションを参照してください。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

インストール スコープを指定します。 指定できる値は次のとおりです。

  • CurrentUser
  • AllUsers

既定のスコープは です CurrentUser。これは、インストールに昇格を必要としません。

スコープは AllUsers 、コンピューターのすべてのユーザーがアクセスできる場所にモジュールをインストールします。 次に例を示します。

  • $env:ProgramFiles\PowerShell\Modules

は CurrentUser 、コンピューターの現在のユーザーのみがアクセスできる場所にモジュールをインストールします。 次に例を示します。

  • $home\Documents\PowerShell\Modules
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

リソースの依存関係のチェックをスキップします。 見つかったリソースのみがインストールされます。 見つかったリソースのリソースはインストールされません。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

実際のインストールの前にリソースを一時的にインストールするパスを指定します。 一時パスが指定されていない場合、リソースは現在のユーザーの一時フォルダーに一時的にインストールされます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

リポジトリを信頼するように求めるプロンプトを表示しない。 リポジトリを信頼するように求めるプロンプトは、リポジトリが信頼済みとして構成されていない場合にのみ発生します。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

返されるリソースのバージョンを指定します。 値には、NuGet バージョン管理構文を使用して、正確なバージョンまたはバージョン範囲を指定できます。

NuGet のバージョン範囲の詳細については、「 パッケージのバージョン管理」を参照してください。

PowerShellGet では、NuGet のバージョン範囲に関するドキュメントに記載されている 最小包括バージョン 以外のすべてをサポートしています。 バージョンとして を使用 1.0.0.0 しても、バージョン 1.0.0.0 以降 (最小包括範囲) は生成されません。 代わりに、値は必要なバージョンと見なされます。 最小包括範囲を検索するには、バージョン範囲として を使用 [1.0.0.0, ] します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

出力

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

既定では、 コマンドレットはオブジェクトを返しません。 PassThru パラメーターを使用すると、コマンドレットは保存されたリソースの PSResourceInfo オブジェクトを出力します。

メモ

モジュールは のエイリアスInstall-PSResourceとして を定義しますisres。

RequiredResource パラメーターと RequiredResourceFile パラメーターは、特定の条件に一致する PSResource オブジェクトを検索するために使用されます。 ハッシュテーブルまたは JSON オブジェクトを使用して検索条件を指定できます。 RequiredResourceFile パラメーターの場合、ハッシュテーブルはファイルに.psd1格納され、JSON オブジェクトはファイルに.json格納されます。 詳細については、「 about_PSResourceGet」を参照してください。