次の方法で共有

Uninstall-PSResource

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

PowerShellGetを使用してインストールされたリソースをアンインストールします。

構文

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

説明

このコマンドレットは、PowerShellGet v2 の Uninstall-Module コマンドレットと Uninstall-Script コマンドレット 機能を組み合わせたものです。 このコマンドレットは、パッケージのインストール パスで、PowerShellGet XML メタデータ ファイルを持つリソースを検索します。 一致するリソースはシステムからアンインストールされます。

既定では、コマンドレットは、削除されるリソースが別のリソースの依存関係であるかどうかを確認します。

例

例 1

Az モジュールの最新バージョンをアンインストールします。

Uninstall-PSResource Az

例 2

Az モジュールの特定のバージョンをアンインストールします。

Uninstall-PSResource -name Az -version "5.0.0"

例 3

指定したバージョン範囲内の Az モジュールのすべてのバージョンをアンインストールします。

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

例 4

この例では、次のバージョンの Az モジュールが既にインストールされていることを前提としています。

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Uninstall-PSResource コマンドレットは、指定されたバージョン範囲内にある安定したプレリリース バージョンを削除します。 NuGetVersion ルールごとに、プレリリース バージョンは安定したバージョンより小さいため、4.0.1-preview は実際には指定された範囲内の 4.0.1 バージョンより小さくなります。 したがって、4.0.1-preview は削除されません。 バージョン 4.1.0 と 4.0.2-preview は範囲内にあるため、削除されます。

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

例 5

この例では、次のバージョンの Az モジュールが既にインストールされていることを前提としています。

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

これは前の例と同じですが、プレリリース パラメーターは、プレリリース バージョンのみが削除されることを意味します。 バージョン 4.0.1-preview が範囲外であり、バージョン 4.1.0 がプレリリース バージョンでないため、バージョン 4.0.2-preview のみが削除されます。

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

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

型:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

削除するリソースの名前。 ワイルドカードはサポートされていますが、NuGet は * 文字のみを受け入れます。

型:String[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-Prerelease

プレリリース バージョンのリソースのみを削除する必要があることを示します。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Scope

アンインストールするリソースのスコープを指定します。

型:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
指定可能な値:CurrentUser, AllUsers
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipDependencyCheck

既定では、コマンドレットは、削除されるリソースが別のリソースの依存関係であるかどうかを確認します。 このパラメーターを使用すると、依存関係テストはスキップされます。

型: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
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

出力