Remove-ItemProperty

構文

Remove-ItemProperty
      [-Path] <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

説明

Remove-ItemProperty コマンドレットは、アイテムからプロパティとその値を削除します。 これを使用して、レジストリ値と、レジストリに格納されているデータを削除できます。

例

例 1: レジストリ値を削除する

このコマンドは、"smpProperty" レジストリ値とそのデータを、"HKEY_LOCAL_MACHINE\Software" レジストリ キーの "SmpApplication" サブキーから削除します。

コマンドはファイル システム ドライブ (PS C:\>) から発行されるため、"SmpApplication" サブキーの完全修飾パス (ドライブ、HKLM:、"ソフトウェア" キーなど) が含まれます。

Name パラメーターを使用して、削除されるレジストリ値を識別します。

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

例 2: HKCU の場所からレジストリ値を削除する

これらのコマンドは、"Options" レジストリ値とそのデータを "HKEY_CURRENT_USER\Software\MyCompany" の "MyApp" サブキーから削除します。

最初のコマンドでは、Set-Location コマンドレットを使用して、現在の場所を HKEY_CURRENT_USER ドライブ (HKCU:) と "Software\MyCompany\MyApp" サブキーに変更します。

2 番目のコマンドでは、Remove-ItemProperty を使用して、"MyApp" サブキーから "Options" レジストリ値とそのデータを削除します。 パス が必要であるため、コマンドはドット ('.') を使用して現在の場所を示します。 名前 を使用して、削除するレジストリ値を指定します。 Confirm パラメーターを使用して、値を削除する前にユーザー プロンプトを要求します。

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

例 3: パイプラインを使用してレジストリ値を削除する

このコマンドは、"NoOfEmployees" レジストリ値とそのデータを "HKLM\Software\MyCompany" レジストリ キーから削除します。

このコマンドでは、Get-Item コマンドレットを使用して、レジストリ キーを表す項目を取得します。 パイプライン演算子 (|) を使用してオブジェクトを Remove-ItemPropertyに送信します。 次に、Remove-ItemProperty の Name パラメーターを使用して、レジストリ値の名前を指定します。

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

パラメーター

-Confirm

-Credential

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Name

-Path

-UseTransaction

-WhatIf

入力

String

リテラル パスではなくパスを含む文字列をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは出力を返しません。

メモ

Windows PowerShell には、Remove-ItemPropertyの次のエイリアスが含まれています。

• rp

PowerShell レジストリ プロバイダーでは、レジストリ値はレジストリ キーまたはサブキーのプロパティと見なされます。 ItemProperty コマンドレットを使用して、これらの値を管理できます。

Remove-ItemProperty は、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。

関連リンク

• Get-Item
• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• New-ItemProperty
• Remove-Item
• Rename-ItemProperty
• Set-ItemProperty
• about_Providers