Share via

Register

  • Artikel

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 Qwordignoreras 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

Exempel