Get-ChildItem

Sintaxis

Items (valor predeterminado)

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

LiteralItems

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint32>]
    [-Force]
    [-Name]
    [-UseTransaction]
    [-Attributes <FlagsExpression[FileAttributes]>]
    [-Directory]
    [-File]
    [-Hidden]
    [-ReadOnly]
    [-System]
    [<CommonParameters>]

Description

Parámetros

-Attributes

Obtiene archivos y carpetas con los atributos especificados. Este parámetro admite todos los atributos y permite especificar combinaciones complejas de atributos.

Por ejemplo, para obtener archivos que no son del sistema (no directorios) cifrados o comprimidos, escriba:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Para buscar archivos y carpetas con atributos usados habitualmente, use el parámetro Atributos. O bien, los parámetros Directory, File, Hidden, ReadOnlyy System.

El parámetro Attributes admite las siguientes propiedades:

• Archive
• Compressed
• Dispositivo
• Directory
• Encriptado
• Escondido
• IntegrityStream
• Normal
• NoScrubData
• NotContentIndexed
• Sin conexión
• ReadOnly
• ReparsePoint
• SparseFile
• Sistema
• Temporary

Para obtener una descripción de estos atributos, vea FileAttributes Enumeration.

Para combinar atributos, use los operadores siguientes:

• ! (NOT)
• + (AND)
• , (OR)

No use espacios entre un operador y su atributo. Se aceptan espacios después de las comas.

Para los atributos comunes, use las abreviaturas siguientes:

• D (directorio)
• H (oculto)
• R (solo lectura)
• S (sistema)

Propiedades de parámetro

Conjuntos de parámetros

-Depth

Este parámetro se agregó en PowerShell 5.0 y le permite controlar la profundidad de recursividad. De forma predeterminada, Get-ChildItem muestra el contenido del directorio primario. El parámetro Depth determina el número de niveles de subdirectorio que se incluyen en la recursividad y muestra el contenido.

Por ejemplo, Depth 2 incluye el directorio del parámetro Path, el primer nivel de subdirectorios y el segundo nivel de subdirectorios. De forma predeterminada, los nombres de directorio y los nombres de archivo se incluyen en la salida.

Propiedades de parámetro

Conjuntos de parámetros

-Directory

Para obtener una lista de directorios, use el parámetro Directory o el parámetro Attributes con la propiedad Directory. Puede usar el parámetro Recurse con Directory.

Propiedades de parámetro

Conjuntos de parámetros

-Exclude

Especifica, como matriz de cadenas, una propiedad o propiedad que este cmdlet excluye de la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento o patrón de ruta, como *.txt o A*. Se aceptan caracteres comodín.

Un asterisco final (*) en el parámetro Path es opcional. Por ejemplo, -Path C:\Test\Logs o -Path C:\Test\Logs\*. Si se incluye un asterisco final (*), el comando se repite en los subdirectorios de Path parámetro. Sin el asterisco (*), se muestra el contenido del parámetro Path. Se incluyen más detalles en el ejemplo 5 y en la sección Notas.

Propiedades de parámetro

Conjuntos de parámetros

-File

Para obtener una lista de archivos, use el parámetro File. Puede usar el parámetro Recurse con File.

Propiedades de parámetro

Conjuntos de parámetros

-Filter

Especifica un filtro para calificar el parámetro Path. El proveedor de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. 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. La cadena de filtro se pasa a la API de .NET para enumerar los archivos. Esa API solo admite caracteres comodín * y ?.

Propiedades de parámetro

Conjuntos de parámetros

-Force

Permite al cmdlet obtener elementos a los que el usuario no puede acceder de otro modo, como archivos ocultos o del sistema. El parámetro Force no invalida las restricciones de seguridad. La implementación varía entre los proveedores. Para obtener más información, consulte about_Providers.

Propiedades de parámetro

Conjuntos de parámetros

-Hidden

Para obtener solo elementos ocultos, use el parámetro Oculto o el parámetro Atributos con la propiedad Oculto. De forma predeterminada, Get-ChildItem no muestra elementos ocultos. Use el parámetro Force para obtener elementos ocultos.

Propiedades de parámetro

Conjuntos de parámetros

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, 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 directorio C:\Windows.

Propiedades de parámetro

Conjuntos de parámetros

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa tal como está escrito. 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 sobre_las_normas_de_citación.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Obtiene solo los nombres de los elementos de la ubicación. La salida es una cadena de texto que se puede enviar por la canalización a otros comandos. Se permiten los caracteres comodín.

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica una ruta de acceso a una o varias ubicaciones. Se aceptan comodines. La ubicación predeterminada es el directorio actual (.).

Propiedades de parámetro

Conjuntos de parámetros

-ReadOnly

Para obtener únicamente elementos de solo lectura, utilice el parámetro ReadOnly o el parámetro Attributes de la propiedad ReadOnly.

Propiedades de parámetro

Conjuntos de parámetros

-Recurse

Obtiene los elementos que se encuentren en las ubicaciones especificadas y en todos los elementos secundarios de dichas ubicaciones.

Propiedades de parámetro

Conjuntos de parámetros

-System

Obtiene solo los archivos y directorios del sistema. Para obtener solo archivos y carpetas del sistema, use el parámetro System, el parámetro Attributes, o la propiedad System.

Propiedades de parámetro

Conjuntos de parámetros

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea about_Transactions.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

String

Salidas

Object

String

Notas

Vínculos relacionados

• about_Certificate_Provider (acerca del proveedor de certificados)
• Acerca de los Proveedores
• about_Quoting_Rules
• acerca_del_proveedor_de_registro
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path