Move-Item

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

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

Командлет Move-Item перемещает элемент, включая его свойства, содержимое и дочерние элементы из одного расположения в другое расположение. Расположения должны поддерживаться тем же поставщиком.

Например, он может переместить файл или подкаталог из одного каталога в другой или переместить подраздел реестра из одного ключа в другой. При перемещении элемента он добавляется в новое расположение и удаляется из исходного расположения.

Эта команда перемещает файл Test.txt из диска C: в каталог E:\Temp и переименовывает его из test.txt в tst.txt.

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

Эта команда перемещает каталог C:\Temp и его содержимое в каталог C:\Logs. Каталог Temp и все его подкаталоги и файлы, а затем отображаются в каталоге Logs.

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

Эта команда перемещает все текстовые файлы (*.txt) в текущем каталоге (представленные точкой (.)) в каталог C:\Logs.

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

Эта команда перемещает все текстовые файлы из текущего каталога и всех подкаталогов, рекурсивно, в каталог C:\TextFiles.

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

Команда использует командлет Get-ChildItem для получения всех дочерних элементов в текущем каталоге (представленных точкой (.)) и его подкаталогами с расширением имени файла *.txt. Он использует параметр Recurse для рекурсивного извлечения и параметра Include, чтобы ограничить извлечение до *.txt файлов.

Оператор конвейера (|) отправляет результаты этой команды в Move-Item, которая перемещает текстовые файлы в каталог TextFiles.

Если файлы, которые необходимо переместить в C:\Textfiles имеют то же имя, Move-Item отображает ошибку и продолжается, но перемещает только один файл с каждым именем в C:\Textfiles. Остальные файлы остаются в исходных каталогах.

Если каталог Textfiles (или любой другой элемент пути назначения) не существует, команда завершается ошибкой. Отсутствующий каталог не создается для вас, даже если используется параметр Force. Move-Item перемещает первый элемент в файл с именем Textfiles, а затем отображает ошибку, объясняющую, что файл уже существует.

Кроме того, по умолчанию Get-ChildItem не перемещает скрытые файлы. Чтобы переместить скрытые файлы, используйте параметр force с .

Эта команда перемещает разделы реестра и значения в разделе реестра MyCompany в HKLM\Software в раздел MyNewCompany. Подстановочный знак (*) указывает, что содержимое ключа MyCompany должно быть перемещено, а не сам ключ. В этой команде опущены необязательные имена параметров пути и назначения.

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

Эта команда перемещает каталог Logs[Sept`06] (и его содержимое) в каталог Logs[2006].

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

Параметр LiteralPath используется вместо пути, так как исходное имя каталога содержит символы левой скобки и правой скобки ([ и ]). Путь также заключен в одинарные кавычки ('), чтобы символ backtick (`) не был неправильно интерпретирован.

Параметр назначения также должен быть заключен в одинарные кавычки, так как он включает скобки, которые могут быть неправильно интерпретированы.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно передать строку, содержащую путь к этому командлету.

По умолчанию этот командлет не возвращает выходные данные.

При использовании параметра PassThru этот командлет возвращает объект, представляющий перемещаемый элемент.

PowerShell включает следующие псевдонимы для Move-Item:

• Все платформы:

  • mi
  • move

• Виндоус:

  • mv

• Этот командлет перемещает файлы между дисками, поддерживаемыми тем же поставщиком, но перемещает каталоги только в одном диске.

• Так как команда Move-Item перемещает свойства, содержимое и дочерние элементы элемента, все перемещения по умолчанию рекурсивны.

• Этот командлет предназначен для работы с данными, предоставляемыми любым провайдером. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе о поставщиках.