Nome provider
Registry
Unità
HKLM:, HKCU:
Descrizione breve
Consente di accedere alle chiavi e ai valori del Registro di sistema da Windows PowerShell.
Descrizione dettagliata
Il provider Registry di Windows PowerShell consente di ottenere, aggiungere, modificare, cancellare ed eliminare le chiavi e i valori del Registro di sistema in Windows PowerShell.
Le chiavi del Registro di sistema vengono rappresentate come istanze della classe Microsoft.Win32.RegistryKey. I valori del Registro di sistema vengono rappresentati come istanze della classe PSCustomObject.
Il provider Registry consente di accedere a uno spazio dei nomi gerarchico costituito da chiavi e sottochiavi del Registro di sistema. I valori e i dati del Registro di sistema non sono componenti di tale gerarchia, ma sono proprietà di ognuna delle chiavi.
Il provider Registry supporta tutti i cmdlet che contengono il sostantivo Item (i cmdlet Item), ad esempio Get-Item, Copy-Item e Rename Item. Utilizzare i cmdlet Item per gestire chiavi e sottochiavi del Registro di sistema. Il provider Registry supporta anche i cmdlet che contengono il sostantivo ItemProperty (i cmdlet ItemProperty). Utilizzare i cmdlet ItemProperty per gestire valori e dati del Registro di sistema. Con il provider Registry non è possibile utilizzare i cmdlet che contengono il sostantivo Content (i cmdlet Content).
Ogni chiave del Registro di sistema è protetta da un descrittore di sicurezza. È possibile utilizzare Get-Acl per visualizzare il descrittore di sicurezza di una chiave.
Funzionalità
ShouldProcess
Esempi
Spostamento nel Registro di sistema
-------------------------- ESEMPIO 1 --------------------------
Questo comando imposta il percorso corrente sulla chiave HKEY_LOCAL_MACHINE\Software del Registro di sistema:
set-location hklm:\software
-------------------------- ESEMPIO 2 --------------------------
In questo comando viene visualizzata la posizione corrente:
get-location
Gestione delle chiavi del Registro di sistema
-------------------------- ESEMPIO 1 --------------------------
In questo comando vengono visualizzate informazioni su ogni sottochiave di primo livello della chiave HKEY_LOCAL_MACHINE\Software del Registro di sistema:
get-childitem -path hklm:\software
-------------------------- ESEMPIO 2 --------------------------
Questo comando crea la sottochiave TestNew nella sottochiave HKCU:\Environment:
new-item -path hkcu:\Environment\TestNew
-------------------------- ESEMPIO 3 --------------------------
Questo comando rimuove la sottochiave TestNew della chiave HKEY_CURRENT_USER\Environment:
remove-item -path hkcu:\Environment\TestNew
-------------------------- ESEMPIO 4 --------------------------
Questo comando copia la chiave TestNew nella sottochiave TestCopy:
copy-item -path hkcu:\Environment\TestNew hkcu:\Environment\TestNew\TestCopy
-------------------------- ESEMPIO 5 --------------------------
In questo comando vengono visualizzate informazioni su tutte le sottochiavi della chiave HKEY_LOCAL_MACHINE\Software del Registro di sistema:
get-childitem -path hklm:\Software -recurse
-------------------------- ESEMPIO 6 --------------------------
Questo comando sposta la chiave HKEY_CURRENT_USER\Environment\testnewcopy del Registro di sistema e le relative proprietà, insieme a tutte le sottochiavi e le relative proprietà, in HKEY_CURRENT_USER\Environment\testnew:
move-item -path hkcu:\environment\testnewcopy ` -destination hkcu:\environment\testnew
-------------------------- ESEMPIO 7 --------------------------
Questo comando rinomina la chiave HKEY_CURRENT_USER\Environment\testnew del Registro di sistema in HKEY_CURRENT_USER\Environment\test:
rename-item -path hkcu:\environment\testnew\ -newname test
-------------------------- ESEMPIO 8 --------------------------
In questo comando viene visualizzato il descrittore di sicurezza per l'elemento del Registro di sistema specificato:
get-acl -path hkcu:\environment\testnew | format-list -property *
Gestione delle voci del Registro di sistema
-------------------------- ESEMPIO 1 --------------------------
In questo comando viene visualizzato il nome del valore e i dati per ogni voce del Registro di sistema contenuta nella chiave HKEY_CURRENT_USER\Environment.
get-itemproperty -path hkcu:\Environment
La voce Default del Registro di sistema viene restituita solo se associata a un valore.
-------------------------- ESEMPIO 2 --------------------------
In questo comando viene visualizzato il nome del valore e i dati della voce Temp del Registro di sistema nella chiave HKEY_CURRENT_USER\Environment:
get-itemproperty -path hkcu:\Environment -name Temp
-------------------------- ESEMPIO 3 --------------------------
Questo comando crea la voce pstest del Registro di sistema nella chiave HKEY_CURRENT_USER e ne imposta il valore su pstestvalue:
new-itemproperty -path hkcu:\environment -name "pstest" -value "pstestvalue"
-------------------------- ESEMPIO 4 --------------------------
Questo comando aggiorna il valore della voce pstest del Registro di sistema nella chiave HKEY_CURRENT_USER\Environment in updatedvalue:
set-itemproperty -path hkcu:\environment -name pstest -value "updatedvalue"
-------------------------- ESEMPIO 5 --------------------------
Questo comando imposta il nome del valore della voce pstest del Registro di sistema nella chiave HKEY_CURRENT_USER\Environment su pstestnew:
rename-itemproperty -path hkcu:\environment -name pstest ` -newname pstestnew
-------------------------- ESEMPIO 6 --------------------------
Questo comando copia la voce pstestnew del Registro di sistema dalla chiave HKEY_CURRENT_USER\Environment alla chiave HKEY_CURRENT_USER\Environment\testnewcopy:
copy-itemproperty -path hkcu:\environment ` -destination hkcu:\environment\testnewcopy -name pstestnew
-------------------------- ESEMPIO 7 --------------------------
Questo comando sposta la voce pstestnew del Registro di sistema dalla chiave HKEY_CURRENT_USER\environment\testnewcopy alla chiave HKEY_CURRENT_USER\Environment\testnew:
move-itemproperty -path hkcu:\environment\testnewcopy ' -destination hkcu:\environment\testnew -name pstestnew
-------------------------- ESEMPIO 8 --------------------------
Questo comando cancella il valore della voce pstestnew del Registro di sistema nella chiave HKEY_CURRENT_USER\Environment\testnew:
clear-itemproperty -path hkcu:\environment\testnew -name pstestnew
È possibile utilizzare il cmdlet Clear-Item per cancellare il valore della voce del Registro di sistema predefinita per una sottochiave. Ad esempio, il comando seguente cancella il valore della voce predefinita della chiave HKEY_CURRENT_USER\Environment\testnew del Registro di sistema: clear-item -path hkcu:\environment\testnew
-------------------------- ESEMPIO 9 --------------------------
Questo comando rimuove la voce pstestnew del Registro di sistema dalla chiave HKEY_CURRENT_USER\Environment\testnew:
remove-itemproperty -path hkcu:\environment\testnew ` -name pstestnew
-------------------------- ESEMPIO 10 --------------------------
Questo comando aggiorna il valore della voce predefinita del Registro di sistema nella chiave HKEY_CURRENT_USER\Environment\testnew in "valore predefinito":
set-itemproperty -path hkcu:\environment\testnew ` -name "(default)" -value "default value"
È inoltre possibile aggiornare il valore predefinito di una chiave del Registro di sistema utilizzando il cmdlet Set-Item. Ad esempio, il comando seguente aggiorna il valore predefinito della chiave testnew: set-item -path hkcu:\environment\testnew -value "altro valore predefinito"
Parametri dinamici
I parametri dinamici sono parametri di cmdlet aggiunti da un provider di Windows PowerShell e disponibili solo quando il cmdlet viene utilizzato nell'unità abilitata dal provider.
Type <Microsoft.Win32.RegistryValueKind>
Specifica i tipi di dati da utilizzare quando si archiviano valori nel Registro di sistema o identifica il tipo di dati di un valore nel Registro di sistema.
Value | Description |
---|---|
String |
Specifica una stringa con terminazione null. Equivale a REG_SZ. |
ExpandString |
Specifica una stringa con terminazione null che contiene riferimenti non espansi alle variabili di ambiente che vengono espanse quando si recupera il valore. Equivale a REG_EXPAND_SZ. |
Binary |
Specifica dati binari in qualsiasi formato. Equivale a REG_BINARY. |
DWord |
Specifica un numero binario a 32 bit. Equivale a REG_DWORD. |
MultiString |
Specifica una matrice di stringhe con terminazione null che terminano con due caratteri null. Equivale a REG_MULTI_SZ. |
QWord |
Specifica un numero binario a 64 bit. Equivale a REG_QWORD. |
Unknown |
Indica un tipo di dati del Registro di sistema non supportato, ad esempio REG_RESOURCE_LIST. |
Cmdlet supportati
Vedere anche