Mueve un elemento de una ubicación a otra.
- Sintaxis
- Descripción
- Ejemplos
- Ejemplo 1: Mover un archivo a otro directorio y renombrarlo
- Ejemplo 2: Mover un directorio y su contenido a otro directorio
- Ejemplo 3: Mover todos los archivos de una extensión especificada del directorio actual a otro directorio
- Ejemplo 4: Mover recursivamente todos los archivos de una extensión especificada del directorio actual a otro directorio
- Ejemplo 5: Mover claves y valores del registro a otra clave
- Ejemplo 6: Mover un directorio y su contenido a un subdirectorio del directorio especificado
- Parámetros
- Entradas
- Salidas
- Notas
Sintaxis
Descripción
El cmdlet Move-Itemmueve un elemento, incluyendo sus propiedades, contenidos y elementos hijos, de una ubicación a otra. Las ubicaciones deben ser compatibles con el mismo proveedor.Por ejemplo, puede mover un archivo o subdirectorio de un directorio a otro o mover una subclave de registro de una clave a otra.Cuando se mueve un elemento, se añade a la nueva ubicación y se elimina de su ubicación original.
Ejemplos
Ejemplo 1: Mover un archivo a otro directorio y renombrarlo
Este comando mueve el archivo Test.txt de la unidad C: al directorio E:\Temp y lo renombra de test.txt a tst.txt.
Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txtEjemplo 2: Mover un directorio y su contenido a otro directorio
Este comando mueve el directorio C:\Temp y su contenido al directorio C:\Logs.El directorio «Temp», y todos sus subdirectorios y archivos, aparecen entonces en el directorio «Logs».
Move-Item -Path C:\Temp -Destination C:\LogsEjemplo 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 directorio C:\Logs.
Move-Item -Path .\*.txt -Destination C:\LogsEjemplo 4: Mover recursivamente todos los archivos de una extensión especificada del directorio actual a otro directorio
Este comando mueve todos los archivos de texto del directorio actual y de todos los subdirectorios, recursivamente, al directorio «C:\TextFiles».
Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"El comando utiliza el cmdlet Get-ChildItempara obtener todos los elementos hijos del directorio actual(representado por el punto ) y sus subdirectorios que tengan una extensión de nombre de archivo «.txt».Utiliza el parámetro Recurse para hacer la recuperación recursiva y el parámetro Include para limitar la recuperación a los archivos «.txt».
El operador pipeline (|) 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 errory continúa, pero mueve sólo un archivo con cada nombre a «C:\Textfiles».Los otros archivos permanecen en sus directorios originales.
Si el directorio «Textfiles» (o cualquier otro elemento de la ruta de destino) no existe, el comando falla.El directorio que falta no se crea para usted, incluso si utiliza el parámetro Force.Move-Item mueve el primer elemento a un archivo llamado «Archivos de texto» y, a continuación, muestra un error que explica que el archivo ya existe.
También, por defecto, Get-ChildItem no mueve los archivos ocultos.Para mover los archivos ocultos, utilice el parámetro Force con Get-ChildItem.
Nota
En Windows PowerShell 2.0, cuando se utiliza el parámetro Recurse del cmdlet Get-ChildItem, el valor del parámetro Path debe ser un contenedor.Utilice el parámetro Include para especificar el filtro de extensión de nombre de archivo .txt(Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).
Ejemplo 5: Mover claves y valores del registro a otra clave
Este comando mueve las claves y valores del registro dentro de la clave del registro «MiEmpresa» enHKLM\Software a la clave «MiNuevaEmpresa».El carácter comodín (*) indica que se debe mover el contenido de la clave «MiEmpresa», no la propia clave.En este comando, se omiten los nombres opcionales de los parámetros Ruta y Destino.
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 directorio «Logs» (y su contenido) al directorio «Logs».
Move-Item -LiteralPath 'Logs' -Destination 'Logs'Se utiliza el parámetro LiteralPath en lugar de Path, porque el nombre original del directorio incluye caracteres de corchete izquierdo y derecho («»).La ruta también se encierra entre comillas simples (‘ ‘), para que no se malinterprete el símbolo de la palomita (`).
El parámetro Destino no requiere una ruta literal, porque la variable Destino también debe ir entre comillas simples, ya que incluye paréntesis que pueden ser malinterpretados.
Parámetros
Pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Posición: | Nombrado |
| Valor por defecto: | Falso |
| Aceptar entrada de tuberías: | False |
| Acepta caracteres comodín: | False |
Este parámetro no es compatible con ningún proveedor instalado con PowerShell.Para suplantar a otro usuario o elevar sus credenciales al ejecutar este cmdlet,utilice Invoke-Command.
| Tipo: | PSCredential |
| Posición: | Nombre |
| Valor por defecto: | Usuario actual |
| Acepta la entrada de la tubería: | Verdadero |
| Acepta caracteres comodín: | Falso |
Especifica la ruta de acceso a la ubicación donde se mueven los elementos.El valor predeterminado es el directorio actual.Se permiten comodines, pero el resultado debe especificar una sola ubicación.
Para cambiar el nombre del elemento que se está moviendo, especifique un nuevo nombre en el valor del parámetro Destino.
| Tipo: | Cadena |
| Posición: | 1 |
| Valor por defecto: | Directorio actual |
| Acepta la entrada de la tubería: | Verdadero |
| Acepta caracteres comodín: | Verdadero |
Especifica, como una 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. Introduzca un elemento o patrón de ruta, como*.txt. Se permiten los caracteres comodín. El parámetro Excluir sólo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Verdadero |
Especifica un filtro para calificar el parámetro Path. El proveedor FileSystem es el único proveedor PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtros de FileSystem en about_Wildcards.Los filtros son más eficientes que otros parámetros, porque el proveedor los aplica cuando el cmdetecta los objetos en lugar de hacer que PowerShell filtre los objetos después de recuperarlos.
| Tipo: | Cadena |
| Posición: | Nombre |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Verdadero |
Forza que el comando se ejecute sin pedir confirmación al usuario.La implementación varía según el proveedor.Para obtener más información, consulte about_Providers.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor por defecto: | False |
| Acepta la entrada de la tubería: | False |
| Acepta caracteres comodín: | False |
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. Introduzca un elemento o patrón de ruta, como"*.txt". Se permiten los caracteres comodín. El parámetro Include sólo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.
| Tipo: | Cadena |
| Posición: | Nombrado |
| Valor por defecto: | Ninguna |
| Acepta la entrada de la tubería: | Falso |
| Acepta caracteres comodín: | Verdadero |
Especifica una ruta a una o más ubicaciones. El valor de LiteralPath se utiliza exactamente como se escribe. No se interpretan caracteres como comodines. Si la ruta incluye caracteres de escape, enciérrela entre comillas simples. Las comillas simples le dicen a PowerShell que no interprete ningún carácter como secuencia de escape.
Para más información, vea about_Quoting_Rules.
| Tipo: | Cadena |
| Alias: | PSPath, LP |
| Posición: | Nombrado |
| Valor por defecto: | Ninguno |
| Acepta entrada de tuberías: | True |
| Acepta caracteres comodín: | False |
Devuelve un objeto que representa el elemento con el que se está trabajando.Por defecto, este cmdlet no genera ninguna salida.
| Tipo: | SwitchParameter |
| Posición: | Nombre |
| Valor por defecto: | False |
| Acepta la entrada de la tubería: | False |
| Acepta caracteres comodín: | False |
Especifica la ruta de la ubicación actual de los elementos.El valor por defecto es el directorio actual.Se permiten caracteres comodín.
| Tipo: | Cadena |
| Posición: | 0 |
| Valor por defecto: | Directorio actual |
| Acepta la entrada de la tubería: | Verdadero |
| Acepta caracteres comodín: | Verdadero |
Muestra lo que ocurriría si el cmdlet se ejecuta.El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Posición: | Nombrado |
| Valor por defecto: | Falso |
| Aceptar entrada de tuberías: | False |
| Acepta caracteres comodín: | False |
Entradas
Cadena
Puede canalizar una cadena que contenga una ruta a este cmdlet.
Salidas
Ninguna o un objeto que representa el elemento movido
Cuando se utiliza el parámetro PassThru, este cmdlet genera un objeto que representa el elemento movido.De lo contrario, este cmdlet no genera ninguna salida.
Notas
- Este cmdlet moverá archivos entre unidades que sean compatibles con el mismo proveedor, pero moverá directorios sólo dentro de la misma unidad.
- Debido a que un comando
Move-Itemmueve las propiedades, el contenido y los elementos hijos de un elemento, todos los movimientos son recursivos por defecto. - Este cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor.Para enumerar los proveedores disponibles en su sesión, escriba
Get-PSProvider.Para obtener más información, consulte about_Providers.
- Borrar-elemento
- Copiar-elemento
- Obtener-elemento
- Invocar-elemento
- Nuevo-elemento
- Quitar-elemento
- Renombrar-elemento
- Configurar-elemento
- sobre_Proveedores