Registrierung

  • Artikel

Übersicht

Verwalten eines Registrierungsschlüssels oder Werts.

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 }]
}

BESCHREIBUNG

Mit der Registry Ressource können Sie Registrierungsschlüssel hinzufügen und entfernen und Registrierungsschlüssel hinzufügen, aktualisieren und entfernen.

Requirements (Anforderungen)

Keine

Parameter

Schlüsseleigenschaften

Schlüssel

Geben Sie den Pfad zum Registrierungsschlüssel als Zeichenfolge an. Dieser Pfad muss die Registrierungsstruktur oder das Laufwerk enthalten, z HKEY_LOCAL_MACHINE . B. oder HKLM:.

Type: System.String
Behavior: Key

ValueName

Geben Sie den Namen des Registrierungswerts als Zeichenfolge an. Um einen Registrierungsschlüssel hinzuzufügen oder zu entfernen, geben Sie diese Eigenschaft als leere Zeichenfolge an, ohne die ValueType - oder ValueData-Eigenschaft anzugeben. Um den Standardwert eines Registrierungsschlüssels zu aktualisieren oder zu entfernen, geben Sie diese Eigenschaft als leere Zeichenfolge mit der ValueType - oder ValueData-Eigenschaft an.

Type: System.String

Optionale Eigenschaften

Ensure

Geben Sie an, ob der Registrierungsschlüssel oder der Wert vorhanden sein soll. Wenn Sie einen Registrierungsschlüssel oder Wert hinzufügen oder aktualisieren möchten, legen Sie diese Eigenschaft auf Present. Um einen Registrierungsschlüssel oder wert zu entfernen, legen Sie diese Eigenschaft auf Absent.

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

Force

Geben Sie an, ob der Registrierungsschlüsselwert überschrieben werden soll, wenn er bereits über einen Wert verfügt oder einen Registrierungsschlüssel mit Unterschlüsseln löschen soll. Standardwert: $false.

Type: System.Boolean
Default Value: false

Hex

Geben Sie an, ob die angegebenen Registrierungsschlüsseldaten in einem Hexadezimalformat bereitgestellt werden. Geben Sie diese Eigenschaft nur an, wenn ValueTypeDWord oder QWord. Wenn ValueType nicht oder QwordnichtDWord, ignoriert die Ressource diese Eigenschaft. Standardwert: $false.

Type: System.Boolean
Default Value: false

ValueData

Geben Sie den Registrierungsschlüsselwert als Zeichenfolge an, oder wenn ValueType ein Array von Zeichenfolgen ist MultiString. Wenn ValueType nicht MultiString und der Wert dieser Eigenschaft mulitple Zeichenfolgen ist, löst die Ressource eine ungültige Argument ausnahme aus.

Type: System.String[]
Default Value: None

ValueType

Geben Sie den Typ für die Daten des angegebenen Registrierungsschlüsselwerts an.

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

Beispiele