Rejestr

  • Artykuł

Streszczenie

Zarządzanie kluczem lub wartością rejestru.

Składnia

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

Opis

Zasób Registry umożliwia dodawanie i usuwanie kluczy rejestru oraz dodawanie, aktualizowanie i usuwanie wartości klucza rejestru.

Wymagania

Brak.

Parametry

Kluczowe właściwości

Klucz

Określ ścieżkę do klucza rejestru jako ciąg. Ta ścieżka musi zawierać gałąź rejestru lub dysk, na przykład HKEY_LOCAL_MACHINE lub HKLM:.

Type: System.String
Behavior: Key

Valuename

Określ nazwę wartości rejestru jako ciąg. Aby dodać lub usunąć klucz rejestru, określ tę właściwość jako pusty ciąg bez określania właściwości ValueType lub ValueData . Aby zaktualizować lub usunąć wartość domyślną klucza rejestru, określ tę właściwość jako pusty ciąg z właściwością ValueType lub ValueData .

Type: System.String

Właściwości opcjonalne

Zapewnienia

Określ, czy klucz rejestru lub wartość powinna istnieć. Aby dodać lub zaktualizować klucz rejestru lub wartość, ustaw tę właściwość na Presentwartość . Aby usunąć klucz rejestru lub wartość, ustaw tę właściwość na Absentwartość .

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

Force

Określ, czy zastąpić wartość klucza rejestru, jeśli ma już wartość, czy usunąć klucz rejestru, który ma podklucze. Wartość domyślna to $false.

Type: System.Boolean
Default Value: false

Hex

Określ, czy określone dane klucza rejestru są udostępniane w formacie szesnastkowym. Określ tę właściwość tylko wtedy, gdy właściwość ValueType ma DWord wartość lub QWord. Jeśli parametr ValueType nie DWord jest lub Qword, zasób ignoruje tę właściwość. Wartość domyślna to $false.

Type: System.Boolean
Default Value: false

ValueData

Określ wartość klucza rejestru jako ciąg lub, jeśli wartość ValueType to MultiString, tablica ciągów. Jeśli parametr ValueType nie MultiString jest i wartość tej właściwości jest ciągami mulitple, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String[]
Default Value: None

ValueType

Określ typ danych określonej wartości klucza rejestru.

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

Przykłady