Update-PSResource

ローカル コンピューターに既にインストールされているパッケージの最新バージョンをダウンロードしてインストールします。

構文

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-PSResource は、ローカル コンピューターに既にインストールされているパッケージの最新バージョンをダウンロードしてインストールします。 このコマンドレットは、PowerShellGet v2 の Update-Module コマンドレットと Update-Script コマンドレットを置き換えます。 新しいバージョンのリソースは、バージョン管理された新しいフォルダーに以前のバージョンと並べてインストールされます。

既定では、 Update-PSResource インストールされている古いバージョンを削除せずに、パッケージの最新バージョンとその依存関係をインストールします。

例 1

この例では、ユーザーは TestModule パッケージが既にインストールされており、パッケージを更新しています。

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

パラメーター

-AcceptLicense

ライセンスが必要なリソースの場合、 AcceptLicense は 更新中にライセンス契約に自動的に同意します。

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

-AuthenticodeCheck

Windows 上の署名済みファイルとカタログ ファイルを検証します。

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

-Force

指定すると、 TrustRepositoryAcceptLicense のチェックがバイパスされ、パッケージが更新されます。

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

-Name

更新する 1 つ以上のリソースの名前を指定します。 ワイルドカードはサポートされていますが、NuGet では 文字のみを受け入れます * 。 NuGet では、ローカル (ファイルベース) リポジトリのワイルドカード検索はサポートされていません。

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

-PassThru

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

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

-Prerelease

を指定すると、プレリリース バージョンへの更新が許可されます。

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

-Quiet

進行状況情報を抑制します。

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

-Repository

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

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

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

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

-Scope

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

  • CurrentUser
  • AllUsers

既定のスコープは です CurrentUser。昇格は必要ありません。

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

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

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:False
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[]

出力

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

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

メモ

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