Compartilhar via


Manipulando itens diretamente

Os elementos que você vê nas unidades do PowerShell, como arquivos e pastas ou chaves do Registro, são chamados de Itens no PowerShell. Os cmdlets para trabalhar com eles item possuem o substantivo Item em seus nomes.

A saída do comando Get-Command -Noun Item mostra que existem nove cmdlets de itens do PowerShell.

Get-Command -Noun Item
CommandType     Name                            Definition
-----------     ----                            ----------
Cmdlet          Clear-Item                      Clear-Item [-Path] <String[]...
Cmdlet          Copy-Item                       Copy-Item [-Path] <String[]>...
Cmdlet          Get-Item                        Get-Item [-Path] <String[]> ...
Cmdlet          Invoke-Item                     Invoke-Item [-Path] <String[...
Cmdlet          Move-Item                       Move-Item [-Path] <String[]>...
Cmdlet          New-Item                        New-Item [-Path] <String[]> ...
Cmdlet          Remove-Item                     Remove-Item [-Path] <String[...
Cmdlet          Rename-Item                     Rename-Item [-Path] <String>...
Cmdlet          Set-Item                        Set-Item [-Path] <String[]> ...

Criar novos itens

Para criar um item no sistema de arquivos, use o cmdlet New-Item. Inclua o parâmetro Path com o caminho para o item e o parâmetro ItemType com um valor de file ou directory.

Por exemplo, para criar um diretório chamado New.Directory no diretório C:\Temp, digite:

New-Item -Path c:\temp\New.Directory -ItemType Directory
    Directory: Microsoft.PowerShell.Core\FileSystem::C:\temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----        2006-05-18  11:29 AM            New.Directory

Para criar um arquivo, altere o valor do parâmetro ItemType para file. Por exemplo, para criar um arquivo chamado file1.txt no diretório New.Directory, digite:

New-Item -Path C:\temp\New.Directory\file1.txt -ItemType file
    Directory: Microsoft.PowerShell.Core\FileSystem::C:\temp\New.Directory

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---        2006-05-18  11:44 AM          0 file1

Você pode usar a mesma técnica para criar uma nova chave do registro. Na verdade, uma chave do registro é mais fácil de criar porque o único tipo de item no registro do Windows é uma chave. (Entradas do Registro são propriedades do item.) Por exemplo, para criar uma chave chamada _Test na subchave CurrentVersion, digite:

New-Item -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\_Test
   Hive: Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion

SKC  VC Name                           Property
---  -- ----                           --------
  0   0 _Test                          {}

Ao digitar um caminho do Registro, é necessário incluir os dois-pontos (:) nos nomes de unidades do Windows PowerShell, HKLM: e HKCU:. Sem os dois pontos, o PowerShell não reconhece o nome da unidade no caminho.

Por que os valores do Registro não são itens

Ao usar o cmdlet Get-ChildItem para localizar os itens em uma chave do Registro, você nunca verá as entradas reais do Registro nem os respectivos valores.

Por exemplo, a chave do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run geralmente contém várias entradas do Registro que representam aplicativos executados quando o sistema é iniciado.

No entanto, ao usar Get-ChildItem para procurar itens filho na chave, tudo o que você verá é a subchave OptionalComponents da chave:

Get-ChildItem HKLM:\Software\Microsoft\Windows\CurrentVersion\Run
   Hive: Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run
SKC  VC Name                           Property
---  -- ----                           --------
  3   0 OptionalComponents             {}

Embora seria algo conveniente tratar as entradas do Registro como itens, não é possível especificar um caminho para uma entrada de Registro de uma maneira que garanta que ele seja exclusivo. A notação de caminho não faz distinção entre a subchave do Registro chamada Run e a entrada do Registro (Default) na subchave Run. Além disso, como nomes de entrada do Registro podem conter o caractere de barra invertida (\), se as entradas de Registro fossem itens, você não poderia usar a notação de caminho para distinguir uma entrada do Registro denominada Windows\CurrentVersion\Run da subchave localizada nesse caminho.

Renomear colunas existentes

Para alterar o nome de uma configuração de sessão, use o cmdlet Rename-Item. O comando a seguir altera o nome do arquivo file1.txt para fileOne.txt.

Rename-Item -Path C:\temp\New.Directory\file1.txt fileOne.txt

O cmdlet Rename-Item pode alterar o nome de um arquivo ou de uma pasta, mas não pode mover um item. O comando a seguir falhará porque ele tenta mover o arquivo da pasta New.Directory para o diretório Temp.

Rename-Item -Path C:\temp\New.Directory\fileOne.txt c:\temp\fileOne.txt
Rename-Item : can't rename because the target specified isn't a path.
At line:1 char:12
+ Rename-Item  <<<< -Path C:\temp\New.Directory\fileOne c:\temp\fileOne.txt

Mover itens

Para mover um arquivo ou uma pasta, use o cmdlet Move-Item.

Por exemplo, o comando a seguir move o diretório New.Directory do diretório C:\temp para a raiz da unidade C:. Para confirmar que o item foi movido, inclua o parâmetro PassThru do cmdlet Move-Item. Sem o Passthru, o cmdlet Move-Item não exibirá nenhum resultado.

Move-Item -Path C:\temp\New.Directory -Destination C:\ -PassThru
    Directory: Microsoft.PowerShell.Core\FileSystem::C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----        2006-05-18  12:14 PM            New.Directory

Copiar itens

Se você estiver familiarizado com as operações de cópia em outros shells, poderá achar o comportamento do cmdlet Copy-Item do PowerShell um tanto incomum. Quando você copia um item de um local para outro, Copy-Item não copia o conteúdo por padrão.

Por exemplo, se você copiar o diretório New.Directory da unidade C: para o diretório C:\temp, o comando será executado com êxito, mas os arquivos no diretório New.Directory não serão copiados.

Copy-Item -Path C:\New.Directory -Destination C:\temp

Se você exibir o conteúdo do C:\temp\New.Directory, verá que ele não contém nenhum arquivo:

PS> Get-ChildItem -Path C:\temp\New.Directory
PS>

Por que o cmdlet Copy-Item não copia o conteúdo para um novo local?

O cmdlet Copy-Item foi elaborado para ser genérico, não apenas para copiar arquivos e pastas. Além disso, mesmo ao copiar arquivos e pastas, convém copiar apenas o contêiner e não os itens dentro dela.

Para copiar todo o conteúdo de uma pasta, inclua o parâmetro Recurse do cmdlet Copy-Item no comando. Se você já copiou o diretório sem o seu conteúdo, adicione o parâmetro Force, que permite substituir a pasta vazia.

Copy-Item -Path C:\New.Directory -Destination C:\temp -Recurse -Force -PassThru
    Directory: Microsoft.PowerShell.Core\FileSystem::C:\temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----        2006-05-18   1:53 PM            New.Directory

    Directory: Microsoft.PowerShell.Core\FileSystem::C:\temp\New.Directory

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---        2006-05-18  11:44 AM          0 file1

Excluindo itens

Para excluir arquivos ou pastas, use o cmdlet Remove-Item. Cmdlets do PowerShell, como Remove-Item, que podem executar alterações significativas e irreversíveis, geralmente solicitarão confirmação ao serem inseridos. Por exemplo, se você tentar remover a pasta New.Directory, será solicitado a confirmar o comando, pois a pasta contém arquivos:

Remove-Item C:\temp\New.Directory
Confirm
The item at C:\temp\New.Directory 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"):

Como Yes é a resposta padrão, para excluir a pasta e seus arquivos, pressione a tecla Enter. Para remover a pasta sem confirmar, use o parâmetro Recurse.

Remove-Item C:\temp\New.Directory -Recurse

Executar itens

O PowerShell usa o cmdlet Invoke-Item para executar uma ação padrão referente a um arquivo ou uma pasta. Essa ação padrão é determinada pelo manipulador de aplicativo padrão no registro. O efeito é o mesmo que clicar duas vezes o item no Explorador de arquivos.

Por exemplo, suponha que você execute o seguinte comando:

Invoke-Item C:\WINDOWS

Aparece uma janela do Explorer localizada em C:\Windows, como se você tivesse clicado duas vezes na pasta C:\Windows.

Se você invocar o arquivo Boot.ini em um sistema anterior ao Windows Vista:

Invoke-Item C:\boot.ini

Se o tipo de arquivo .ini estiver associado ao Bloco de Notas, o arquivo boot.ini será aberto nele.