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>]

El cmdlet Move-Item mueve un elemento, incluidas sus propiedades, contenido y elementos secundarios, de una ubicación a otra. El mismo proveedor debe admitir las ubicaciones. Por ejemplo, puede mover un archivo o subdirectorio de un directorio a otro o mover una subclave del Registro de una clave a otra. Al mover un elemento, se agrega a la nueva ubicación y se elimina de su ubicación original.

Este comando mueve el archivo "Test.txt" de la unidad C: al directorio "E:\Temp" y lo cambia de "test.txt" a "tst.txt".

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

Este comando mueve el directorio "C:\Temp" y su contenido al directorio "C:\Logs". El directorio "Temp" y todos sus subdirectorios y archivos, a continuación, aparecen en el directorio "Registros".

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

Este comando mueve todos los archivos de texto ("*.txt") en el directorio actual (representado por un punto ('.')) en el directorio "C:\Logs".

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

Este comando mueve todos los archivos de texto del directorio actual y todos los subdirectorios, de forma recursiva, al directorio "C:\TextFiles".

El comando usa el cmdlet Get-ChildItem para obtener todos los elementos secundarios del directorio actual (representados por el punto [.]) y sus subdirectorios que tienen una extensión de nombre de archivo ".txt". Usa el parámetro Recurse para que la recuperación sea recursiva y el parámetro Include para limitar la recuperación a los archivos ".txt".

El operador de canalización (|) envía los resultados de este comando a Move-Item, que mueve los archivos de texto al directorio "TextFiles".

Si los archivos que se van a mover a "C:\Textfiles" tienen el mismo nombre, Move-Item muestra un error y continúa, pero solo mueve un archivo con cada nombre a "C:\Textfiles". Los demás archivos permanecen en sus directorios originales.

Si el directorio "Textfiles" (o cualquier otro elemento de la ruta de acceso de destino) no existe, se produce un error en el comando. El directorio que falta no se crea automáticamente, incluso si usa el parámetro Force. Move-Item mueve el primer elemento a un archivo denominado "Textfiles" y, a continuación, muestra un error que explica que el archivo ya existe.

Además, de forma predeterminada, Get-ChildItem no mueve archivos ocultos. Para mover archivos ocultos, use el parámetro Force con Get-ChildItem.

Nota: En Windows PowerShell 2.0, cuando se usa el parámetro Recurse del cmdlet de Get-ChildItem, el valor del parámetro Path debe ser un contenedor. Use el parámetro include para especificar el filtro de extensión de nombre de archivo .txt ().

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

Este comando mueve las claves y los valores del Registro dentro de la clave del Registro "MyCompany" en "HKLM\Software" a la clave "MyNewCompany". El carácter comodín ('*') indica que se debe mover el contenido de la tecla "MyCompany", no la propia clave. En este comando, se omiten los nombres de parámetro opcionales Path y Destination.

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

Este comando mueve el directorio "Logs[Sep'06]" (y su contenido) al directorio "Logs[2006]".

El parámetro LiteralPath se usa en lugar de Path, ya que el nombre del directorio original incluye caracteres de corchete izquierdo y corchete derecho ("[" y "]"). La ruta de acceso también se incluye entre comillas simples (' '), de modo que el símbolo de retroceso (') no esté mal interpretado.

El parámetro Destination no requiere una ruta de acceso literal, ya que la variable Destination también debe incluirse entre comillas simples, ya que incluye corchetes que se pueden interpretar incorrectamente.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede enviar una cadena que contenga una ruta de acceso a este cmdlet.

Cuando se usa el parámetro PassThru, este cmdlet genera un objeto que representa el elemento movido. De lo contrario, este cmdlet no genera ninguna salida.

Este cmdlet moverá los archivos entre unidades compatibles con el mismo proveedor, pero solo moverá directorios dentro de la misma unidad.

Dado que un comando Move-Item mueve las propiedades, el contenido y los elementos secundarios de un elemento, todos los movimientos son recursivos de forma predeterminada.

Este cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.