Trabalhando com chaves do Registro

Artigo
11/04/2024

Este exemplo só se aplica a plataformas Windows.

Como as chaves do Registro são itens em unidades do PowerShell, trabalhar com elas é muito semelhante a trabalhar com arquivos e pastas. Uma diferença fundamental é que cada item em uma unidade do PowerShell com base no Registro é um contêiner, assim como uma pasta em uma unidade de sistema de arquivos. No entanto, as entradas do Registro e seus valores associados são propriedades de itens, não itens distintos.

Listar todas as subchaves de uma chave do Registro

Você pode mostrar todos os itens diretamente em uma chave do Registro usando Get-ChildItem. Adicione o parâmetro opcional Force para exibir itens ocultos ou do sistema. Por exemplo, este comando exibe os itens diretamente na unidade do PowerShell HKCU:, que corresponde ao hive do Registro HKEY_CURRENT_USER:

Get-ChildItem -Path HKCU:\ | Select-Object Name

   Hive: Microsoft.PowerShell.Core\Registry::HKEY_CURRENT_USER

Name
----
HKEY_CURRENT_USER\AppEvents
HKEY_CURRENT_USER\Console
HKEY_CURRENT_USER\Control Panel
HKEY_CURRENT_USER\DirectShow
HKEY_CURRENT_USER\dummy
HKEY_CURRENT_USER\Environment
HKEY_CURRENT_USER\EUDC
HKEY_CURRENT_USER\Keyboard Layout
HKEY_CURRENT_USER\MediaFoundation
HKEY_CURRENT_USER\Microsoft
HKEY_CURRENT_USER\Network
HKEY_CURRENT_USER\Printers
HKEY_CURRENT_USER\Software
HKEY_CURRENT_USER\System
HKEY_CURRENT_USER\Uninstall
HKEY_CURRENT_USER\WXP
HKEY_CURRENT_USER\Volatile Environment

Essas são as chaves de nível superior em HKEY_CURRENT_USER no Editor do Registro (regedit.exe).

Você também pode especificar esse caminho de Registro definindo o nome do provedor do Registro, seguido por ::. O nome completo do provedor do Registro é Microsoft.PowerShell.Core\Registry, mas isso pode ser reduzido para apenas Registry. Qualquer um dos comandos a seguir lista o conteúdo diretamente em HKCU:.

Get-ChildItem -Path Registry::HKEY_CURRENT_USER
Get-ChildItem -Path Microsoft.PowerShell.Core\Registry::HKEY_CURRENT_USER
Get-ChildItem -Path Registry::HKCU
Get-ChildItem -Path Microsoft.PowerShell.Core\Registry::HKCU
Get-ChildItem HKCU:

Esses comandos listam apenas os itens contidos diretamente, similar ao uso do comando DIR do cmd.exe ou ls em um shell do UNIX. Para mostrar os itens contidos, você precisa especificar o parâmetro Recurse. Use o comando a seguir para listar todas as chave do Registro em HKCU:.

Get-ChildItem -Path HKCU:\ -Recurse

Get-ChildItem pode executar as funcionalidades de filtragem complexas por meio de seus parâmetros Path, Filter, Include e Exclude, mas esses parâmetros normalmente são baseados apenas no nome. Você pode executar a filtragem complexa com base em outras propriedades de itens usando o cmdlet Where-Object. O comando a seguir encontra todas as chaves no HKCU:\Software que têm, no máximo, uma subchave e que também têm exatamente quatro valores:

Get-ChildItem -Path HKCU:\Software -Recurse |
    Where-Object {($_.SubKeyCount -le 1) -and ($_.ValueCount -eq 4) }

Copiar chaves

A cópia é feita com Copy-Item. O exemplo a seguir copia a subchave CurrentVersion de HKLM:\SOFTWARE\Microsoft\Windows\ e todas as suas propriedades para HKCU:\.

Copy-Item -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion' -Destination HKCU:

Se você examinar essa nova chave no editor do Registro ou por meio de Get-ChildItem, observará que não há cópias das subchaves contidas no novo local. Para copiar todo o conteúdo de um contêiner, você precisa especificar o parâmetro Recurse. Para tornar o comando de cópia anterior recursivo, você usaria este comando:

Copy-Item -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion' -Destination HKCU: -Recurse

Você ainda pode usar outras ferramentas que já estão disponíveis para executar cópias do sistema de arquivos. Quaisquer ferramentas de edição de Registro, incluindo reg.exe, regini.exe, regedit.exe e objetos COM que dão suporte à edição do Registro, como o WScript.Shell e a classe StdRegProv do WMI, podem ser usados de dentro do PowerShell.

Criar chaves

Criar novas chaves no Registro é mais simples do que criar um novo item em um sistema de arquivos. Como todas as chaves do Registro são contêineres, você não precisa especificar o tipo de item. Basta fornecer um caminho explícito, como:

New-Item -Path HKCU:\Software_DeleteMe

Você também pode usar um caminho de provedor para especificar uma chave:

New-Item -Path Registry::HKCU\Software_DeleteMe

Excluir chaves

Excluir itens é essencialmente o mesmo para todos os provedores. Os seguintes comandos removerão itens silenciosamente:

Remove-Item -Path HKCU:\Software_DeleteMe
Remove-Item -Path 'HKCU:\key with spaces in the name'

Remover todas as chaves sob uma chave específica

É possível remover os itens contidos usando Remove-Item, mas será solicitado que você confirme a remoção se o item contiver qualquer outra coisa. Por exemplo, se tentarmos excluir a subchave HKCU:\CurrentVersion que criamos, veremos isto:

Remove-Item -Path HKCU:\CurrentVersion

Confirm
The item at HKCU:\CurrentVersion\AdminDebug has children and the -recurse
parameter was not specified. If you continue, all children will be removed with
the item. Are you sure you want to continue?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Para excluir os itens contidos sem nenhuma solicitação, especifique o parâmetro Recurse:

Remove-Item -Path HKCU:\CurrentVersion -Recurse

Se desejar remover todos os itens dentro de HKCU:\CurrentVersion, mas não o HKCU:\CurrentVersion em si, você poderá usar:

Remove-Item -Path HKCU:\CurrentVersion\* -Recurse

Compartilhar via