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




Argomenti della Guida