次の方法で共有

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

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

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

パラメーター

-Confirm

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

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

-InputObject

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

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

-Name

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

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

-Prerelease

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

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

-Scope

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

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

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

出力

Object