Move-Item

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Mueve un elemento de una ubicación a otra.

Syntax

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

Description

El Move-Item cmdlet mueve un elemento, incluidas sus propiedades, contenido y elementos secundarios, de una ubicación a otra. Las ubicaciones deben ser compatibles con el mismo proveedor.

Por ejemplo, puede mover un archivo o un subdirectorio de un directorio a otro, o mover una subclave del Registro de una clave a otra. Cuando se mueve un elemento, se agrega a la nueva ubicación y se elimina de la ubicación original.

Ejemplos

Ejemplo 1: Mover un archivo a otro directorio y cambiar su nombre

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

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

Ejemplo 2: Mover un directorio y su contenido a otro directorio

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

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

Ejemplo 3: Mover todos los archivos de una extensión especificada del directorio actual a otro directorio

Este comando mueve todos los archivos de texto (*.txt) del directorio actual (representado por un punto (.)) al C:\Logs directorio.

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

Ejemplo 4: Mover recursivamente todos los archivos de una extensión especificada desde el directorio actual a otro directorio

Este comando mueve todos los archivos de texto desde el directorio actual y todos los subdirectorios, recursivamente, al C:\TextFiles directorio .

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

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

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

Si los archivos que se van a mover tienen C:\Textfiles 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 permanecerán en sus directorios originales.

Si el Textfiles directorio (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, aunque use el parámetro Force . Move-Item mueve el primer elemento a un archivo llamado 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 Get-ChildItem cmdlet, el valor del parámetro Path debe ser un contenedor. Use el parámetro Include para especificar el filtro de extensión de *.txt nombre de archivo (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Ejemplo 5: Traslado de claves y valores del Registro a otra clave

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

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

Ejemplo 6: Mover un directorio y su contenido a un subdirectorio del directorio especificado

Este comando mueve el Logs[Sept`06] directorio (y su contenido) al Logs[2006] directorio .

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

El parámetro LiteralPath se usa en lugar de Path, ya que el nombre del directorio original incluye el corchete izquierdo y los caracteres del corchete derecho ([ y ]). La ruta de acceso también se incluye entre comillas simples ('), por lo que el símbolo de la barra diagonal (`) no está malinterpretado.

El parámetro Destination también debe incluirse entre comillas simples porque incluye corchetes que se pueden interpretar incorrectamente.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Nota:

Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Destination

Especifica la ruta de acceso a la ubicación a la que se están moviendo los elementos. El valor predeterminado es el directorio actual. No se permiten caracteres comodín.

Para cambiar el nombre del elemento que se va a mover, especifique un nuevo nombre en el valor del parámetro Destination .

Type:String
Position:1
Default value:Current directory
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows directorio.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Especifica un filtro para calificar el parámetro Path . El proveedor FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro FileSystem en about_Wildcards. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario. La implementación varía en función del proveedor. Para obtener más información, consulte about_Providers.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, como *.txt. Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows directorio.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples ('). Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Para obtener más información, consulte about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devuelve un objeto que representa el elemento movido. De forma predeterminada, este cmdlet no genera ningún resultado.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica la ruta de acceso a la ubicación actual de los elementos. El valor predeterminado es el directorio actual. Se permite el uso de caracteres comodín.

Type:String[]
Position:0
Default value:Current directory
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

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

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

PSObject

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto que representa el elemento movido.

Notas

PowerShell incluye los siguientes alias para Move-Item:

  • Todas las plataformas:

    • mi
    • move

  • Windows:

    • mv

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

  • Dado que un Move-Item comando 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.