レジストリ

[アーティクル]
05/05/2023

構文

レジストリキーまたは値を管理します。

構文

Registry [String] #ResourceName
{
    Key = [string]
    ValueName = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Force = [bool]]
    [Hex = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [ValueData = [string[]]]
    [ValueType = [string]{ Binary | DWord | ExpandString | MultiString | QWord | String }]
}

説明

この Registry リソースを使用すると、レジストリキーを追加および削除したり、レジストリキーの値を追加、更新、削除したりできます。

要件

[なし] :

パラメーター

キーのプロパティ

キー

レジストリキーへのパスを文字列として指定します。このパスには、レジストリハイブやドライブ (HKEY_LOCAL_MACHINEHKLM:または .

Type: System.String
Behavior: Key

ValueName

レジストリ値の名前を文字列として指定します。レジストリキーを追加または削除するには、 ValueType プロパティまたは ValueData プロパティを指定せずに、このプロパティを空の文字列として指定します。レジストリキーの既定値を更新または削除するには、 ValueType プロパティまたは ValueData プロパティを使用して、このプロパティを空の文字列として指定します。

Type: System.String

省略可能なプロパティ

Ensure

レジストリキーまたは値が存在するかどうかを指定します。レジストリキーまたは値を追加または更新するには、このプロパティを Present. レジストリキーまたは値を削除するには、このプロパティをに設定します Absent。

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

レジストリキーの値が既に存在する場合は上書きするか、サブキーを持つレジストリキーを削除するかを指定します。既定値は $false です。

Type: System.Boolean
Default Value: false

Hex

指定したレジストリキーデータを 16 進数形式で指定するかどうかを指定します。このプロパティは 、ValueType の DWord 場合にのみ指定します QWord。 ValueType が指定されていないDWord場合、リソースQwordはこのプロパティを無視します。既定値は $false です。

Type: System.Boolean
Default Value: false

ValueData

レジストリキーの値を文字列として指定するか、 ValueType の場合は MultiString文字列の配列を指定します。 ValueType が指定されておらずMultiString、このプロパティの値が複数の文字列である場合、リソースは無効な引数例外をスローします。

Type: System.String[]
Default Value: None

ValueType

指定したレジストリキー値のデータの型を指定します。

Type: System.String
Accepted Values:
  - Binary
  - DWord
  - ExpandString
  - MultiString
  - QWord
  - String
Default Value: String

Share via