Set-ItemProperty

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

Set-ItemProperty
    [-Path] <String[]>
    -InputObject <PSObject>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

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

Set-ItemProperty
    -LiteralPath <String[]>
    -InputObject <PSObject>
    [-PassThru]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-ItemProperty コマンドレットは、指定した項目のプロパティの値を変更します。 コマンドレットを使用して、項目のプロパティを確立または変更できます。 たとえば、Set-ItemProperty を使用して、ファイル オブジェクトの IsReadOnly プロパティの値を $Trueに設定できます。

Set-ItemProperty を使用して、レジストリ値とデータを作成および変更することもできます。 たとえば、新しいレジストリ エントリをキーに追加し、その値を確立または変更できます。

このコマンドは、"final.doc" ファイルの IsReadOnly プロパティの値を "true" に設定します。 Path を使用してファイルを指定し、Name を使用してプロパティの名前を指定し、Value パラメーターを使用して新しい値を指定します。

ファイルは System.IO.FileInfo オブジェクト であり、IsReadOnly はそのプロパティの 1 つです。 すべてのプロパティを表示するには、「Get-Item C:\GroupFiles\final.doc | Get-Member -MemberType Property」と入力します。

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

Set-ItemProperty -Path C:\GroupFiles\final.doc -Name IsReadOnly -Value $true

この例では、Set-ItemProperty を使用して新しいレジストリ エントリを作成し、エントリに値を割り当てる方法を示します。 "HKLM\Software" キーの "ContosoCompany" キーに "NoOfEmployees" エントリを作成し、その値を 823 に設定します。

レジストリ エントリは、項目であるレジストリ キーのプロパティと見なされるため、Set-ItemProperty を使用してレジストリ エントリを作成し、その値を確立および変更します。

最初のコマンドは、レジストリ エントリを作成します。 Path を使用して、HKLM: ドライブのパスと "Software\MyCompany" キーを指定します。 このコマンドでは、Name を使用してエントリ名を指定し、値を指定する値 します。

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

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

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

HKLM: ドライブの詳細については、「Get-Help Get-PSDrive」と入力します。 PowerShell を使用してレジストリを管理する方法の詳細については、「Get-Help Registry」と入力します。

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 823
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

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

Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 824
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"

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

これらのコマンドは、パイプライン演算子 (|) を使用してアイテムを Set-ItemProperty に送信する方法を示しています。

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

このコマンドは、 InputObject パラメーターを使用して、 Get-ChildItem が取得するオブジェクトを指定するのと同じです。

Get-ChildItem weekly.txt | Set-ItemProperty -Name IsReadOnly -Value $True

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットにオブジェクトをパイプできます。

このコマンドレットは、変更された項目とその新しいプロパティ値を表す PSCustomObject オブジェクトを生成します (PassThru パラメーターを指定した場合)。 それ以外の場合、このコマンドレットは出力を生成しません。

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