Registr

  • Článek

Synopse

Správa klíče nebo hodnoty registru

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

Prostředek Registry umožňuje přidávat a odebírat klíče registru a přidávat, aktualizovat a odebírat hodnoty klíče registru.

Požadavky

Žádné

Parametry

Základní vlastnosti

Klíč

Zadejte cestu k klíči registru jako řetězec. Tato cesta musí obsahovat podregistr registru nebo jednotku, například HKEY_LOCAL_MACHINE nebo HKLM:.

Type: System.String
Behavior: Key

Valuename

Zadejte název hodnoty registru jako řetězec. Chcete-li přidat nebo odebrat klíč registru, zadejte tuto vlastnost jako prázdný řetězec bez zadání ValueType nebo ValueData vlastnost. Chcete-li aktualizovat nebo odebrat výchozí hodnotu klíče registru, zadejte tuto vlastnost jako prázdný řetězec s ValueType nebo ValueData vlastnost.

Type: System.String

Volitelné vlastnosti

Zajištění

Určete, jestli má klíč registru nebo hodnota existovat. Chcete-li přidat nebo aktualizovat klíč registru nebo hodnotu, nastavte tuto vlastnost na Present. Chcete-li odebrat klíč registru nebo hodnotu, nastavte tuto vlastnost na Absenthodnotu .

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

Force

Určete, zda chcete přepsat hodnotu klíče registru, pokud již má hodnotu, nebo odstranit klíč registru, který má podklíče. Výchozí hodnota je $false.

Type: System.Boolean
Default Value: false

Hex

Zadejte, zda jsou zadaná data klíče registru zadána v šestnáctkovém formátu. Tuto vlastnost zadejte pouze v případě, že hodnota ValueType je DWord nebo QWord. Pokud hodnota ValueType není DWord nebo Qword, prostředek tuto vlastnost ignoruje. Výchozí hodnota je $false.

Type: System.Boolean
Default Value: false

ValueData

Zadejte hodnotu klíče registru jako řetězec, nebo pokud hodnota ValueType je MultiString, pole řetězců. Pokud hodnota ValueType není MultiString a hodnota této vlastnosti je mulitple řetězce, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String[]
Default Value: None

ValueType

Zadejte typ pro data zadané hodnoty klíče registru.

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

Příklady