Move-Item

Dez 18, 2021
Module: Microsoft.PowerShell.Management

Mova um item de um local para outro.

>

Sintax

>

Descrição

OMove-Item cmdlet move um item, incluindo suas propriedades, conteúdo e itens filhos, do onelocation para outro local. Por exemplo, ele pode mover um arquivo ou subdiretório de um diretório para outro ou mover um registrysubkey de uma chave para outra. Quando você move um item, ele é adicionado ao novo local e excluído de seu local original.

Exemplos

Exemplo 1: Move um ficheiro para outro directório e renomeia-o

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

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

Exemplo 2: Move um directório e o seu conteúdo para outro directório

Este comando move o directório C:\Temp e o seu conteúdo para o directório C:\Logs. O directório “Temp”, e todas as suas subdirectorias e ficheiros, aparecem depois no directório “Logs”.

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

Exemplo 3: Move todos os ficheiros de uma extensão especificada do directório actual para outro directório

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

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

Exemplo 4: Move recursivamente todos os ficheiros de uma extensão especificada do directório actual para outro directório

Este comando move todos os ficheiros de texto do directório actual e todas as subdirectorias, recursivamente, para o directório “C:\TextFiles”.

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

Este comando usa o comando Get-ChildItem cmdlet para obter todos os itens filhos no directório actual(representado pelo ponto ) e as suas subdirectorias que têm um “.Ele usa o parâmetro Recurse para tornar a recuperação recursiva e o parâmetro Include para limitar a recuperação a ficheiros “.txt”.

O operador do pipeline (|) envia os resultados deste comando para Move-Item, que move os ficheiros de texto para o directório “TextFiles”.

Se os ficheiros a serem movidos para “C:\Arquivos de texto” tiverem o mesmo nome, Move-Item mostra um erro e continua, mas move apenas um ficheiro com cada nome para “C:\Arquivos de texto”. Os outros ficheiros permanecem nos directórios originais.

Se o directório “Ficheiros de texto” (ou qualquer outro elemento do caminho de destino) não existir, o comando falha.O directório em falta não é criado para si, mesmo que utilize o parâmetro Force.Move-Item move o primeiro item para um ficheiro chamado “Textfiles” e depois mostra um erro explicando que o ficheiro já existe.

Também, por defeito, Get-ChildItem não move ficheiros ocultos.Para mover ficheiros ocultos, use o parâmetro Force com Get-ChildItem.

Nota

No Windows PowerShell 2.0, quando utilizar o parâmetro Recurse do Get-ChildItem cmdlet, o valor do parâmetro Path deve ser um contentor. Utilize o parâmetro Incluir para especificar o filtro de extensão do nome do ficheiro .txt(Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Exemplo 5: Mover chaves de registo e valores para outra chave

Este comando move as chaves de registo e valores dentro da chave de registo “MyCompany” emHKLM\Software para a chave “MyNewCompany”.O carácter curinga (*) indica que o conteúdo da chave “MyCompany” deve ser movido, não a própria chave. Neste comando, os nomes opcionais dos parâmetros Path e Destination são omitidos.

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

Exemplo 6: Move um directório e o seu conteúdo para um subdirectório do directório especificado

Este comando move o directório “Logs” (e o seu conteúdo) para o directório “Logs”.

Move-Item -LiteralPath 'Logs' -Destination 'Logs'

O parâmetro LiteralPath é utilizado em vez de Path, porque o nome do directório original inclui os caracteres entre parênteses à esquerda e à direita (“”). O path também está entre aspas simples (‘ ‘), de modo a que o símbolo do backtick (`) não seja interpretado.

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

Parâmetros

-Confirmar

Prompta-o para confirmação antes de executar o cmdlet.

Tipo: SwitchParameter
Aliases: cf
Posição: Nome
Valor por defeito: Falso
Aceitar entrada da conduta: Falso
Aceitar caracteres wildcard: Falso
Credencial

Nota

Este parâmetro não é suportado por nenhum provedor instalado com PowerShell.Para se fazer passar por outro utilizador, ou elevar as suas credenciais ao executar esta cmdlet, utilize o Invoke-Command.

Type: PSCredential
Posição: Nomeado
Valor por defeito: Usuário actual:
Aceitar entrada do pipeline: Verdade
Aceitar caracteres wildcard: Falso
Destino

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

Para renomear o item sendo movido, especifique um novo nome no valor do parâmetro Destino.

Tipo: Cadeia
Posição: 1
Valor padrão: Diretório atual:
Aceitar entrada do pipeline: Verdade
Aceitar caracteres curinga: Verdade

-Excluir

Especifica, como uma string array, um item ou itens que este cmdlet exclui na operação. O valor deste parâmetro qualifica o parâmetro Path. Introduza um elemento ou padrão de caminho, como por exemplo*.txt. Os caracteres curinga são permitidos. O parâmetro Exclude só é efectivo quando o comando inclui o conteúdo de um item, tal como C:\Windows\*, onde os caracteres wildcard especificam o conteúdo do directório C:\Windows.

Type: String
Posição: Nomeado
Valor por defeito: Nenhum
Aceitar entrada do pipeline: Falso
Aceitar caracteres curinga: Verdade
Filtro

Especifica um filtro para qualificar o parâmetro Caminho. O FileSystemprovider é o único fornecedor PowerShell instalado que suporta o uso de filtros. Você pode encontrar a sintaxe para a linguagem do filtro FileSystem em about_Wildcards.Filters são mais eficientes que outros parâmetros, porque o provedor os aplica quando o cmdlet esquece os objetos em vez de ter o PowerShell filtrando os objetos depois que eles são recuperados.

Type: String
Posição: Nome
Valor por defeito: Nenhum
Aceitar entrada do pipeline: Falso
Aceitar caracteres wildcard: Verdade
Força

Força o comando a correr sem pedir confirmação ao utilizador.A implementação varia de provedor para provedor. Para mais informações, veja about_Providers.

Tipo: SwitchParameter
Posição: Nome:
Valor padrão: Falso
Aceitar entrada do pipeline: Falso
Aceitar caracteres curinga: Falso
Incluir

Especifica, como uma string array, um item ou itens que este cmdlet inclui na operação. O valor deste parâmetro qualifica o parâmetro Path. Introduza um elemento ou padrão de caminho, como por exemplo"*.txt". Os caracteres curinga são permitidos. O parâmetro Include só é eficaz quando o comando inclui o conteúdo de um item, tal como C:\Windows\*, onde os caracteres curinga especificam o conteúdo do directório C:\Windows.

Type: String
Posição: Nome
Valor por defeito: Nenhum
Aceitar entrada do pipeline: Falso
Aceitar caracteres wildcard: Verdade
Caminho-Literal

Especifica um caminho para um ou mais locais. O valor do LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como wildcards. Se o caminho incluir caracteres de escape, inclua-os entre aspas simples. As aspas simples dizem ao PowerShell para não interpretar nenhum caracteresas seqüências de escape.

Para mais informações, veja about_Quoting_Rules.

Type: String
Aliases: PSPath, LP
Position: Nome
Valor por defeito: Nenhum
Aceitar entrada da conduta: Verdade
Aceitar caracteres wildcard: Falso
-PassThru

Retorna um objeto representando o item com o qual você está trabalhando.Por padrão, este cmdlet não gera nenhuma saída.

Type: SwitchParameter
Position: Named
Valor por defeito: False
Aceptar entrada do pipeline: Falso
Aceitar caracteres wildcard: Falso
Caminho

Especifica o caminho para a localização actual dos itens.O padrão é o diretório atual.Os caracteres curinga são permitidos.

Type: String
Posição: >0
Valor padrão: Diretório atual:
>Conceitar entrada do pipeline: Verdade
Aceitar caracteres wildcard: Verdade
– E se

Mostra o que aconteceria se o cmdlet funcionasse.O cmdlet não é executado.

Tipo: SwitchParameter
Aliases: wi
Posição: Nome
Valor por defeito: Falso
Aceitar entrada da conduta: Falso
Aceitar caracteres wildcard: Falso

Entradas

Cadeia

Pode canalizar uma string que contém um caminho para esta cmdlet.

Entradas

Nenhum ou um objeto representando o item movido

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

Notas

  • Este cmdlet irá mover arquivos entre drives que são suportados pelo mesmo provedor, mas irá mover diretórios somente dentro do mesmo drive.
  • Porque um comando Move-Item move as propriedades, conteúdo e itens filhos de um item, todos os movimentos são recursivos por padrão.
  • Este cmdlet é projetado para trabalhar com os dados expostos por qualquer provedor.Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider.Para mais informações, veja about_Providers.
  • Clear-Item
  • Copy-Item
  • Get-Item
  • Invoque-Item
  • Novo-Item
  • Remover-Item
  • Rename-Item
  • Set-Item
  • Set-Item
  • Sobre_Provedores

Deixe uma resposta

O seu endereço de email não será publicado.