Mova um item de um local para outro.
>
- Sintax
- Descrição
- Exemplos
- Exemplo 1: Move um ficheiro para outro directório e renomeia-o
- Exemplo 2: Move um directório e o seu conteúdo para outro directório
- Exemplo 3: Move todos os ficheiros de uma extensão especificada do directório actual para outro directório
- Exemplo 4: Move recursivamente todos os ficheiros de uma extensão especificada do directório actual para outro directório
- Exemplo 5: Mover chaves de registo e valores para outra chave
- Exemplo 6: Move um directório e o seu conteúdo para um subdirectório do directório especificado
- Parâmetros
- Entradas
- Entradas
- Notas
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
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 |
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 |
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 |
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 |
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 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 |
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 |
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 |
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 |
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 |
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