Condividi tramite

Registro

Riepilogo

Gestire una chiave o un valore del Registro di sistema.

Sintassi

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

Descrizione

La Registry risorsa consente di aggiungere e rimuovere chiavi del Registro di sistema e di aggiungere, aggiornare e rimuovere i valori delle chiavi del Registro di sistema.

Requisiti

No.

Parametri

Proprietà della chiave

Chiave

Specificare il percorso della chiave del Registro di sistema come stringa. Questo percorso deve includere l'hive o l'unità del Registro di sistema, ad esempio HKEY_LOCAL_MACHINE o HKLM:.

Type: System.String
Behavior: Key

ValueName

Specificare il nome del valore del Registro di sistema come stringa. Per aggiungere o rimuovere una chiave del Registro di sistema, specificare questa proprietà come stringa vuota senza specificare la proprietà ValueType o ValueData . Per aggiornare o rimuovere il valore predefinito di una chiave del Registro di sistema, specificare questa proprietà come stringa vuota con la proprietà ValueType o ValueData .

Type: System.String

Proprietà facoltative

Ensure

Specificare se deve esistere la chiave o il valore del Registro di sistema. Per aggiungere o aggiornare una chiave o un valore del Registro di sistema, impostare questa proprietà su Present. Per rimuovere una chiave o un valore del Registro di sistema, impostare questa proprietà su Absent.

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

Force

Specificare se sovrascrivere il valore della chiave del Registro di sistema se ha già un valore o eliminare una chiave del Registro di sistema con sottochiavi. Il valore predefinito è $false.

Type: System.Boolean
Default Value: false

Hex

Specificare se i dati della chiave del Registro di sistema specificati vengono forniti in formato esadecimale. Specificare questa proprietà solo quando ValueType è DWord o QWord. Se ValueType non DWord è o Qword, la risorsa ignora questa proprietà. Il valore predefinito è $false.

Type: System.Boolean
Default Value: false

ValueData

Specificare il valore della chiave del Registro di sistema come stringa oppure, se ValueType è MultiString, una matrice di stringhe. Se ValueType non MultiString è e il valore di questa proprietà è stringhe mulitple, la risorsa genera un'eccezione di argomento non valida.

Type: System.String[]
Default Value: None

ValueType

Specificare il tipo per i dati della chiave del Registro di sistema specificati.

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

Esempi

  • Last updated on