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