Partilhar via

Move-Item

  • Referência
Módulo:
Microsoft.PowerShell.Management

Move um item de um local para outro.

Sintaxe

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

Description

O Move-Item cmdlet 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.

Exemplos

Exemplo 1: Mover um arquivo para outro diretório e renomeá-lo

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

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

Exemplo 2: Mover um diretório e seu conteúdo para outro diretório

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

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

Exemplo 3: Mover todos os arquivos de uma extensão especificada do diretório atual para outro diretório

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

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

Exemplo 4: Mover recursivamente todos os arquivos de uma extensão especificada do diretório atual para outro diretório

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

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

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

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

Se os arquivos que devem ser movidos tiverem C:\Textfiles 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 Textfiles diretório (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.

Nota

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

Exemplo 5: Mover chaves e valores do Registro para outra chave

Este comando move as chaves do Registro e os valores dentro da chave do MyCompany Registro para HKLM\Software a MyNewCompany chave. O caractere curinga (*) indica que o MyCompany conteúdo da chave 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"

Exemplo 6: Mover um diretório e seu conteúdo para um subdiretório do diretório especificado

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

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination '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 também deve ser colocado entre aspas simples, pois inclui colchetes que podem ser mal interpretados.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Nota

Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.

Tipo:PSCredential
Position:Named
Default value:Current user
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Destination

Especifica o caminho para o local onde os itens estão sendo movidos. O padrão é o diretório atual. Curingas são permitidos, mas o resultado deve ser resolvido em um único local.

Para renomear o item que está sendo movido, especifique um novo nome no valor do parâmetro Destination .

Tipo:String
Position:1
Default value:Current directory
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Exclude

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui na operação. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como *.txt. Caracteres curinga são permitidos. O parâmetro Exclude é efetivo somente quando o comando inclui o conteúdo de um item, como , onde C:\Windows\*o caractere curinga especifica o C:\Windows conteúdo do diretório.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Filter

Especifica um filtro para qualificar o parâmetro Path . O provedor FileSystem é o único provedor PowerShell instalado que oferece suporte ao uso de filtros. Você pode encontrar a sintaxe para a linguagem de filtro FileSystem em about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, porque o provedor os aplica quando o cmdlet obtém os objetos em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Force

Força o comando a ser executado sem pedir a confirmação do usuário. A implementação varia de fornecedor para fornecedor. Para obter mais informações, consulte about_Providers.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Include

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor desse parâmetro qualifica o parâmetro Path . Insira um elemento ou padrão de caminho, como *.txt. Caracteres curinga são permitidos. O parâmetro Include só é efetivo quando o comando inclui o conteúdo de um item, como , onde C:\Windows\*o caractere curinga especifica o C:\Windows conteúdo do diretório.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-LiteralPath

Especifica o caminho para o local atual dos itens. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples ('). Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Para obter mais informações, consulte about_Quoting_Rules.

Tipo:String[]
Aliases:PSPath
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Retorna um objeto que representa o item movido. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica o caminho para o local atual dos itens. O padrão é o diretório atual. Caracteres curinga são permitidos.

Tipo:String[]
Position:0
Default value:Current directory
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido somente quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Tipo:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

PSObject

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto que representa o item movido.

Notas

O Windows PowerShell inclui os seguintes aliases para Move-Item:

  • mi

  • move

  • mv

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

  • Como um Move-Item comando 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.