Get-ChildItem
Obtiene los elementos y los elementos secundarios de una o más ubicaciones especificadas.
Sintaxis
Get-ChildItem [[-Path] <string[]>] [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Get-ChildItem [-LiteralPath] <string[]> [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-ChildItem obtiene los elementos de una o más ubicaciones especificadas. Si el elemento es un contenedor, obtiene los elementos del contenedor, denominados elementos secundarios. Puede utilizar el parámetro Recurse para obtener elementos de todos los contenedores secundarios.
Una ubicación puede ser una ubicación del sistema de archivos, como un directorio, o una ubicación expuesta por otro proveedor, como un subárbol del Registro o un almacén de certificados.
Parámetros
-Exclude <string[]>
Omite los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Filter <string>
Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Force
Permite al cmdlet obtener elementos a los que el usuario no puede tener acceso de ningún otro modo, como archivos ocultos o del sistema. La implementación varía según el proveedor. Para obtener más información, vea about_Providers. Incluso si se usa el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Recupera únicamente los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
El parámetro Include sólo es efectivo cuando el comando incluye el parámetro Recurse o la ruta lleva al contenido de un directorio, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\ de Windows.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica una ruta de acceso a una o más ubicaciones. A diferencia de Path, el valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Name
Recupera únicamente los nombres de los elementos de las ubicaciones. Si canaliza el resultado de este comando a otro comando, sólo se enviarán los nombres de los elementos.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica una ruta de acceso a una o más ubicaciones. Se permite el uso de caracteres comodín. La ubicación predeterminada es el directorio actual (.).
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Recurse
Obtiene los elementos y los elementos secundarios de las ubicaciones especificadas.
La recursividad solo funciona cuando la ruta de acceso señala un contenedor con elementos secundarios, como C:\Windows o C:\Windows\*, pero no funciona cuando señala elementos que no tienen elementos secundarios, como C:\Windows\*.exe.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.String Puede canalizar una cadena que contiene una ruta de acceso a Get-ChildItem. |
Salidas |
Objeto. El tipo de objeto que Get-ChildItem devuelve está determinado por el proveedor con que se utiliza. |
Notas
También puede hacer referencia a Get-ChildItem mediante sus alias integrados "ls", "dir" y "gci". Para obtener más información, vea about_Aliases.
Get-ChildItem no obtiene elementos ocultos de forma predeterminada. Para obtener elementos ocultos, use -Force.
El cmdlet Get-ChildItem está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PsProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>get-childitem
Descripción
-----------
Este comando obtiene los elementos secundarios de la ubicación actual. Si la ubicación es un directorio del sistema de archivos, obtiene los archivos y subdirectorios del directorio actual. Si el elemento no tiene elementos secundarios, este comando vuelve al símbolo del sistema sin mostrar nada.
La presentación predeterminada muestra el modo (atributos), la hora de última escritura, el tamaño del archivo y el nombre del archivo. Los valores válidos para el modo son d (directorio), a (archivo), r (solo lectura), h (oculto) y s (sistema).
Ejemplo 2
C:\PS>get-childitem . -include *.txt -recurse -force
Descripción
-----------
Este comando recupera todos los archivos .txt del directorio actual y sus subdirectorios. El punto (.) representa el directorio actual y el parámetro Include especifica la extensión del nombre de archivo. El parámetro Recurse hace que Windows PowerShell recupere objetos de forma recursiva e indica que el objeto del comando es el directorio especificado y su contenido. El parámetro Force agrega archivos ocultos a la presentación.
Ejemplo 3
C:\PS>get-childitem c:\windows\logs\* -include *.txt -exclude A*
Descripción
-----------
Este comando muestra los archivos .txt del subdirectorio Logs, con la excepción de aquéllos cuyos nombres empiecen por la letra A. Usa el carácter comodín (*) para indicar el contenido del subdirectorio Logs, no el contenedor del directorio. Como el comando no incluye el parámetro Recurse, Get-ChildItem no incluye el contenido de directorio automáticamente; se debe especificar.
Ejemplo 4
C:\PS>get-childitem registry::hklm\software
Descripción
-----------
Este comando recupera todas las claves de la clave HKEY_LOCAL_MACHINE\Software del Registro del equipo local.
Ejemplo 5
C:\PS>get-childitem -name
Descripción
-----------
Este comando recupera únicamente los nombres de los elementos del directorio actual.
Ejemplo 6
C:\PS>get-childitem cert:\. -recurse -codesigningcert
Descripción
-----------
Este comando obtiene todos los certificados del almacén de certificados que tienen autoridad para firmar código.
El comando utiliza el cmdlet Get-ChildItem. La ruta especifica la unidad Cert: expuesta por el proveedor Certificate de Windows PowerShell. El símbolo de barra diagonal inversa (\) especifica un subdirectorio del almacén de certificados y el punto (.) representa el directorio actual, que será el directorio raíz del almacén de certificados. El parámetro Recurse especifica una búsqueda recursiva.
El parámetro CodeSigningCertificate es un parámetro dinámico que obtiene únicamente certificados con autoridad de firma de código. Para obtener más información, escriba "get-help certificate".
Ejemplo 7
C:\PS>get-childitem * -include *.exe
Descripción
-----------
Este comando recupera todos los elementos del directorio actual con la extensión de nombre de archivo ".exe". El carácter comodín (*) representa el contenido del directorio actual (no el contenedor). Al usar el parámetro Include sin el parámetro Recurse, la ruta debe indicar el contenido, no un contenedor.