Set-ItemProperty

Set-ItemProperty [-LiteralPath] <string[]> -InputObject <psobject> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-ItemProperty [-Path] <string[]> -InputObject <psobject> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-ItemProperty [-LiteralPath] <string[]> [-Name] <string> [-Value] <Object> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Set-ItemProperty [-Path] <string[]> [-Name] <string> [-Value] <Object> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-確認] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>set-itemproperty -path c:\GroupFiles\final.doc -name IsReadOnly -value $true

説明
-----------
このコマンドは、final.doc ファイルの IsReadOnly プロパティの値を true に設定します。

このコマンドは、Set-ItemProperty コマンドレットを使用して final.doc ファイルのプロパティの値を変更します。ファイルは Path パラメーターを使用して指定しています。また、プロパティの名前は Name パラメーターを使用し、新しい値は Value パラメーターを使用して指定します。

$true 自動変数は TRUE の値を表します。詳細については、「about_Automatic_Variables」を参照してください。

ファイルは System.IO.FileInfo オブジェクトで、IsReadOnly はそのプロパティの 1 つにすぎません。FileInfo オブジェクトのプロパティとメソッドをすべて表示するには、Get-Member コマンドレットに対してファイルをパイプ処理します。たとえば、"final.doc | get-member" などです。

C:\PS>set-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 823

C:\PS>get-itemproperty -path HKLM:\Software\MyCompany

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 823

C:\PS>set-itemproperty -path HKLM:\Software\MyCompany -name NoOfEmployees -value 824
C:\PS>get-itemproperty -path HKLM:\Software\MyCompany


PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 824

説明
-----------
この例は、Set-ItemProperty を使用して新しいレジストリ エントリを作成し、値をエントリに割り当てる方法を示します。このコマンドを実行すると、HKLM\Software キー内の MyCompany キーに NoOfEmployees エントリが作成され、その値が 823 に設定されます。

レジストリ エントリはレジストリ キー (項目) のプロパティと見なされるため、Set-ItemProperty を使用してレジストリ エントリを作成し、値の設定と変更を行います。

最初のコマンドは、Set-ItemProperty コマンドレットを使用してレジストリ エントリを作成します。このコマンドは、Path パラメーターを使用して、HKLM: ドライブと Software\MyCompany キーへのパスを指定します。また、エントリの名前は Name パラメーターを使用し、値は Value パラメーターを使用して指定します。

2 番目のコマンドは、Get-ItemProperty コマンドレットを使用して、新しいレジストリ エントリを表示します。エントリは項目や子項目でなくキーのプロパティであるため、Get-Item または Get-ChildItem コマンドレットを使用する場合、エントリは表示されません。

3 番目のコマンドは、NoOfEmployees エントリの値を 824 に変更します。

New-ItemProperty コマンドレットを使用して、レジストリ エントリとその値を作成してから、Set-ItemProperty を使用して値を変更することもできます。

HKLM: ドライブの詳細については、「get-help get-psdrive」と入力してください。Windows PowerShell を使用してレジストリを管理する方法の詳細については、「get-help registry」と入力してください。

C:\PS>get-childitem weekly.txt | set-itemproperty -name IsReadOnly -value $true

説明
-----------
これらのコマンドは、パイプライン演算子 (|) を使用して項目を Set-ItemProperty に渡す方法を示しています。

コマンドの最初の部分は Get-ChildItem コマンドレットを使用して、Weekly.txt ファイルを表すオブジェクトを取得します。このコマンドは、パイプライン演算子を使用してファイル オブジェクトを Set-ItemProperty に渡します。Set-ItemProperty コマンドは Name パラメーターおよび Value パラメーターを使用して、プロパティとその新しい値を指定します。

このコマンドを実行すると、InputObject パラメーターを使用して Get-ChildItem が取得するオブジェクトを指定した場合と同じ結果が返されます。