HOME > ItemProperty系コマンドレット > Set-ItemProperty
Set-ItemProperty
Set-ItemPropertyは、アイテムプロパティの値を設定するコマンドです。
エイリアスsp
解説
指定されたアイテムのプロパティ値を設定または変更します。
ファイルシステムやレジストリなどで使用できます
構文
- (構文)
- Set-ItemProperty [-Path] <string[]> [-Name] <string> [-Value] <Object> [<CommonParameters>] Set-ItemProperty [-Path] <string[]> [<CommonParameters>] Set-ItemProperty [-Name] <string> [-Value] <Object> [<CommonParameters>] Set-ItemProperty [<CommonParameters>]
パラメータ | 説明 |
---|---|
-Path パス | プロパティ値を設定または変更するアイテムのパスを指定する ※必須パラメータ (例)-Path "HKLM:\Software\MyCompany\MyApp" |
-LiteralPath パス | 対象パスを指定する(ワイルドカード使用不可) (例)-LiteralPath "D:\test" |
-Name プロパティ名 | 設定または変更するプロパティの名前を指定する ※必須パラメータ (例)-Name "Setting" |
-Value 値 | プロパティに設定する新しい値を指定する ※必須パラメータ (例)-Value "NewValue" |
-InputObject オブジェクト | プロパティを設定する項目を指定する |
-PathThru | 設定されたプロパティのオブジェクトを出力する |
-Force | 読取専用や既存のプロパティを上書きして設定する |
-Include 文字列 | 指定した文字列を対象に含める (ワイルドカード使用可) (例)-Include *.log,*.tmp ⇒拡張子がlog、tmpのファイルを含める |
-Exclude 文字列 | 指定した文字列を対象から除外する (ワイルドカード使用可) (例)-Exclude Test* ⇒ファイルがTestで始まる物を除外する |
-WhatIf | 実行はせずに実行結果の確認のみ行う |
-Confirm | 実行前に確認メッセージの表示を行う |
共通的なパラメータは「共通パラメータ」をご覧ください。
サンプル
C:\sample.txtのファイル作成日を2024/01/01 10:20:30に変更する
Set-ItemProperty C:\sample.txt -Name CreationTime -Value "2024/01/01 10:20:30"
C:\sample.txtのファイル更新日を2024/01/01 10:20:30に変更する
Set-ItemProperty C:\sample.txt -Name LastWriteTime -Value "2024/01/01 10:20:30"
C:\sample.txtの最終ファイルアクセス日を2024/01/01 10:20:30に変更する
Set-ItemProperty C:\sample.txt -Name LastAccessTime -Value "2024/01/01 10:20:30"
レジストリキーのプロパティ値を設定する
Set-ItemProperty -Path "HKLM:\Software\MyCompany\MyApp" -Name "Setting" -Value "NewValue"
整数型のプロパティ値を設定する
Set-ItemProperty -Path "HKLM:\Software\MyCompany\MyApp" -Name "IntegerSetting" -Value 42
単一のオブジェクトを指定する
$item = Get-Item -Path C:\Test\file.txt
Set-ItemProperty -InputObject $item -Name IsReadOnly -Value $true
コマンドのヘルプを表示する
Get-Help Set-ItemProperty
備考
- 一部のプロパティの設定には管理者権限が必要です。その場合はPowershellを管理者として起動してコマンドを実行してください。
関連項目
- ItemProperty系コマンドレット
- Clear-ItemProperty:アイテムプロパティの値のみをクリアする
- Copy-ItemProperty:アイテムプロパティをコピーする
- Get-ItemProperty:アイテムプロパティ情報を取得する
- Move-ItemProperty:アイテムプロパティを移動する
- New-ItemProperty:アイテムプロパティを新規作成する
- Rename-ItemProperty:アイテムプロパティ名を変更する
- Remove-ItemProperty:アイテムプロパティを削除する
- Set-ItemProperty:アイテムプロパティの値を設定する