Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

O cmdlet Move-Item move um item, incluindo suas propriedades, conteúdo e itens filho, de um local para outro. Os locais devem ser suportados pelo mesmo provedor. Por exemplo, ele pode mover um arquivo ou subdiretório de um diretório para outro ou mover uma subchave do Registro de uma chave para outra. Quando você move um item, ele é adicionado ao novo local e excluído do local original.

Este comando move o arquivo "Test.txt" da unidade C: para o diretório "E:\Temp" e o renomeia de "test.txt" para "tst.txt".

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

Este comando move o diretório "C:\Temp" e seu conteúdo para o diretório "C:\Logs". O diretório "Temp" e todos os seus subdiretórios e arquivos, em seguida, aparecem no diretório "Logs".

Move-Item -Path C:\Temp -Destination C:\Logs

Este comando move todos os arquivos de texto ("*.txt") no diretório atual (representado por um ponto ('.')) para o diretório "C:\Logs".

Move-Item -Path .\*.txt -Destination C:\Logs

Este comando move todos os arquivos de texto do diretório atual e todos os subdiretórios, recursivamente, para o diretório "C:\TextFiles".

O comando usa o cmdlet Get-ChildItem para obter todos os itens filho no diretório atual (representado pelo ponto [.]) e seus subdiretórios que têm uma extensão de nome de arquivo ".txt". Ele usa o parâmetro Recurse para tornar a recuperação recursiva e o parâmetro Include para limitar a recuperação a arquivos ".txt".

O operador de pipeline (|) envia os resultados deste comando para Move-Item, que move os arquivos de texto para o diretório "TextFiles".

Se os arquivos que devem ser movidos para "C:\Textfiles" tiverem o mesmo nome, Move-Item exibirá um erro e continuará, mas moverá apenas um arquivo com cada nome para "C:\Textfiles". Os outros arquivos permanecem em seus diretórios originais.

Se o diretório "Textfiles" (ou qualquer outro elemento do caminho de destino) não existir, o comando falhará. O diretório ausente não é criado para você, mesmo se você usar o parâmetro Force. Move-Item move o primeiro item para um arquivo chamado "Textfiles" e, em seguida, exibe um erro explicando que o arquivo já existe.

Além disso, por padrão, Get-ChildItem não move arquivos ocultos. Para mover arquivos ocultos, use o parâmetro Force com Get-ChildItem.

Observação: no Windows PowerShell 2.0, ao usar o parâmetro Recurse do cmdlet , o valor do parâmetro Path da deve ser um contêiner. Use o parâmetro Include para especificar o filtro de extensão de nome de arquivo .txt (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

Este comando move as chaves e valores do Registro dentro da chave do Registro "MyCompany" em "HKLM\Software" para a chave "MyNewCompany". O caractere curinga ('*') indica que o conteúdo da chave "MyCompany" deve ser movido, não a chave em si. Neste comando, os nomes opcionais dos parâmetros Path e Destination são omitidos.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

Este comando move o diretório "Logs[Sept'06]" (e seu conteúdo) para o diretório "Logs[2006]".

O parâmetro LiteralPath é usado em vez de Path, porque o nome do diretório original inclui caracteres entre colchetes esquerdo e direito ("[" e "]"). O caminho também é colocado entre aspas simples (' '), para que o símbolo de backtick (') não seja mal interpretado.

O parâmetro Destination não requer um caminho literal, porque a variável Destination também deve ser colocada entre aspas simples, pois inclui colchetes que podem ser mal interpretados.

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este cmdlet.

Quando você usa o parâmetro PassThru, esse cmdlet gera um objeto que representa o item movido. Caso contrário, esse cmdlet não gerará nenhuma saída.

Esse cmdlet moverá arquivos entre unidades suportadas pelo mesmo provedor, mas moverá diretórios somente dentro da mesma unidade.

Como um comando Move-Item move as propriedades, o conteúdo e os itens filho de um item, todas as movimentações são recursivas por padrão.

Este cmdlet foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.