Register
Synopsis
Hantera en registernyckel eller ett värde.
Syntax
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 }]
}
Description
Med resursen Registry
kan du lägga till och ta bort registernycklar och lägga till, uppdatera och ta bort registernyckelvärden.
Krav
Inga.
Parametrar
Nyckelegenskaper
Nyckel
Ange sökvägen till registernyckeln som en sträng. Den här sökvägen måste innehålla registreringsdatafilen eller enheten, till exempel HKEY_LOCAL_MACHINE
eller HKLM:
.
Type: System.String
Behavior: Key
ValueName
Ange namnet på registervärdet som en sträng. Om du vill lägga till eller ta bort en registernyckel anger du den här egenskapen som en tom sträng utan att ange egenskapen ValueType eller ValueData . Om du vill uppdatera eller ta bort standardvärdet för en registernyckel anger du den här egenskapen som en tom sträng med egenskapen ValueType eller ValueData .
Type: System.String
Valfria egenskaper
Säkerställa
Ange om registernyckeln eller värdet ska finnas. Om du vill lägga till eller uppdatera en registernyckel eller ett värde anger du den här egenskapen till Present
. Om du vill ta bort en registernyckel eller ett värde anger du den här egenskapen till Absent
.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
Force
Ange om registernyckelvärdet ska skrivas över om det redan har ett värde eller om du vill ta bort en registernyckel som har undernycklar. Standardvärdet är $false
.
Type: System.Boolean
Default Value: false
Hex
Ange om angivna registernyckeldata tillhandahålls i hexadecimalt format. Ange endast den här egenskapen när ValueType är DWord
eller QWord
. Om ValueType inte DWord
är eller Qword
ignoreras den här egenskapen av resursen. Standardvärdet är $false
.
Type: System.Boolean
Default Value: false
ValueData
Ange registernyckelvärdet som en sträng eller, om ValueType är MultiString
, en matris med strängar. Om ValueType inte MultiString
är det och den här egenskapens värde är mulitplesträngar genererar resursen ett ogiltigt argumentfel.
Type: System.String[]
Default Value: None
Värdetyp
Ange typen för det angivna registernyckelvärdets data.
Type: System.String
Accepted Values:
- Binary
- DWord
- ExpandString
- MultiString
- QWord
- String
Default Value: String