Get-ChildItem

Referencia

Módulo:: Microsoft.PowerShell.Management

Obtiene los elementos y elementos secundarios de una o varias ubicaciones especificadas.

Sintaxis

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

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

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

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

Description

El Get-ChildItem cmdlet obtiene los elementos de una o varias ubicaciones especificadas. Si el elemento es un contenedor, obtiene los elementos que se encuentran dentro del contenedor, denominados elementos secundarios. Puede usar el parámetro Recurse para obtener elementos de todos los contenedores secundarios y usar el parámetro Depth para limitar el número de niveles a recurse.

Get-ChildItem no muestra directorios vacíos. Cuando un Get-ChildItem comando incluye los parámetros Depth o Recurse , los directorios vacíos no se incluyen en la salida.

Los proveedores de PowerShell exponen Get-ChildItem las ubicaciones. Una ubicación puede ser un directorio del sistema de archivos, un subárbol del Registro o un almacén de certificados. Algunos parámetros solo están disponibles para un proveedor específico. Para obtener más información, consulte about_Providers.

Ejemplos

Ejemplo 1: Obtener elementos secundarios de un directorio del sistema de archivos

En este ejemplo se obtienen los elementos secundarios de un directorio del sistema de archivos. Se muestran los nombres de nombre de archivo y subdirectorio. En el caso de las ubicaciones vacías, el comando no devuelve ninguna salida y vuelve al símbolo del sistema de PowerShell.

El Get-ChildItem cmdlet usa el parámetro Path para especificar el directorio C:\Test. Get-ChildItem muestra los archivos y directorios en la consola de PowerShell.

Get-ChildItem -Path C:\Test

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     08:29                Logs
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a----         2/1/2019     08:43            183 CreateTestFile.ps1
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

De forma predeterminada Get-ChildItem , se muestra el modo (Atributos), LastWriteTime, el tamaño de archivo (Longitud) y el nombre del elemento. Las letras de la propiedad Mode se pueden interpretar de la siguiente manera:

l (vínculo)
d (directorio)
a (archivo)
r (solo lectura)
h (oculto)
s (sistema)

Para obtener más información sobre las marcas de modo, consulte about_Filesystem_Provider.

Ejemplo 2: Obtener nombres de elementos secundarios en un directorio

En este ejemplo solo se enumeran los nombres de los elementos de un directorio.

El Get-ChildItem cmdlet usa el parámetro Path para especificar el directorio C:\Test. El parámetro Name devuelve solo los nombres de archivo o directorio de la ruta de acceso especificada. Los nombres devueltos son relativos al valor del parámetro Path .

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

Ejemplo 3: Obtener elementos secundarios en el directorio y subdirectorios actuales

En este ejemplo se muestran .txt los archivos que se encuentran en el directorio actual y sus subdirectorios.

Get-ChildItem -Path .\*.txt -Recurse -Force

Directory: C:\Test\Logs\Adirectory

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile4.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile4.txt

    Directory: C:\Test\Logs\Backup

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 ATextFile.txt
-a----        2/12/2019     15:50             20 LogFile3.txt

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

El Get-ChildItem cmdlet usa el parámetro Path para especificar C:\Test\*.txt. La ruta de acceso usa el comodín asterisco (*) para especificar todos los archivos con la extensión .txtde nombre de archivo . El parámetro Recurse busca en el directorio Path y sus subdirectorios, como se muestra en los encabezados Directory: . El parámetro Force muestra archivos ocultos, como hiddenfile.txt que tienen un modo h.

Ejemplo 4: Obtener elementos secundarios mediante el parámetro Include

En este ejemplo Get-ChildItem se usa el parámetro Include para buscar elementos específicos del directorio especificado por el parámetro Path .

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt



Get-ChildItem -Path C:\Test\* -Include *.txt

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

El Get-ChildItem cmdlet usa el parámetro Path para especificar el directorio C:\Test. El parámetro Path incluye un carácter comodín de asterisco final (*) para especificar el contenido del directorio. El parámetro Include usa un comodín asterisco (*) para especificar todos los archivos con la extensión .txtde nombre de archivo .

Cuando se usa el parámetro Include , el parámetro Path necesita un carácter comodín asterisco final (*) para especificar el contenido del directorio. Por ejemplo, -Path C:\Test\*.

Si el parámetro Recurse se agrega al comando , el asterisco final (*) del parámetro Path es opcional. El parámetro Recurse obtiene elementos del directorio Path y sus subdirectorios. Por ejemplo: -Path C:\Test\ -Recurse -Include *.txt
Si no se incluye un asterisco final (*) en el parámetro Path , el comando no devuelve ninguna salida y vuelve al símbolo del sistema de PowerShell. Por ejemplo, -Path C:\Test\.

Ejemplo 5: Obtener elementos secundarios mediante el parámetro Exclude

La salida del ejemplo muestra el contenido del directorio C:\Test\Logs. La salida es una referencia para los demás comandos que usan los parámetros Exclude y Recurse .

Get-ChildItem -Path C:\Test\Logs

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

El Get-ChildItem cmdlet usa el parámetro Path para especificar el directorio C:\Test\Logs. El parámetro Exclude usa el comodín asterisco (*) para especificar los archivos o directorios que comienzan por A o a se excluyen de la salida.

Cuando se usa el parámetro Exclude , un asterisco final (*) en el parámetro Path es opcional. Por ejemplo, -Path C:\Test\Logs o -Path C:\Test\Logs\*.

Si no se incluye un asterisco final (*) en el parámetro Path , se muestra el contenido del parámetro Path . Las excepciones son nombres de archivo o subdirectorios que coinciden con el valor del parámetro Exclude .
Si se incluye un asterisco final (*) en el parámetro Path , el comando se repite en los subdirectorios del parámetro Path . Las excepciones son nombres de archivo o subdirectorios que coinciden con el valor del parámetro Exclude .
Si el parámetro Recurse se agrega al comando , la salida de recursión es la misma si el parámetro Path incluye o no un asterisco final (*).

Ejemplo 6: Obtención de las claves del Registro de un subárbol del Registro

En este ejemplo se obtienen todas las claves del Registro de HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem usa el parámetro Path para especificar la clave HKLM:\HARDWAREdel Registro . La ruta de acceso de Hive y el nivel superior de las claves del Registro se muestran en la consola de PowerShell.

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

Get-ChildItem -Path HKLM:\HARDWARE

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name             Property
----             --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI

Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name                           Property
----                           --------
ACPI
RESOURCEMAP

El primer comando muestra el contenido de la clave del HKLM:\HARDWARE Registro. El parámetro Exclude indica Get-ChildItem que no devuelva ninguna subclave que comience por D*. Actualmente, el parámetro Exclude solo funciona en subclaves, no en propiedades de elemento.

Ejemplo 7: Obtención de todos los certificados con entidad de firma de código

En este ejemplo se obtiene cada certificado de la unidad de PowerShell Cert: que tiene entidad de firma de código.

El Get-ChildItem cmdlet usa el parámetro Path para especificar el proveedor de certificados con la Cert: unidad. El parámetro Recurse busca en el directorio especificado por Path y sus subdirectorios. El parámetro CodeSigningCert solo obtiene certificados que tienen entidad de firma de código.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

Para obtener más información sobre el proveedor de certificados y la Cert: unidad, consulte about_Certificate_Provider.

Ejemplo 8: Obtener elementos mediante el parámetro Depth

En este ejemplo se muestran los elementos de un directorio y sus subdirectorios. El parámetro Depth determina el número de niveles de subdirectorio que se van a incluir en la recursividad. Los directorios vacíos se excluyen de la salida.

Get-ChildItem -Path C:\Parent -Depth 2

Directory: C:\Parent

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level1
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level2
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1\SubDir_Level2

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:22                SubDir_Level3
-a----        2/13/2019     08:55             26 file.txt

El Get-ChildItem cmdlet usa el parámetro Path para especificar C:\Parent. El parámetro Depth especifica dos niveles de recursividad. Get-ChildItem muestra el contenido del directorio especificado por el parámetro Path y los dos niveles de subdirectorios.

Ejemplo 9: Obtención del destino del vínculo para un punto de unión

El dir comando del Shell de comandos de Windows muestra la ubicación de destino de un punto de unión del sistema de archivos. En PowerShell, esta información está disponible en la propiedad Target del objeto filesystem devuelto por Get-ChildItem.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object name,*target

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

Ejemplo 10: Obtención del destino del vínculo para un punto de reanálisis de AppX

En este ejemplo se intenta obtener la información de destino de un punto de reanálisis de AppX. Las aplicaciones de Microsoft Store crean puntos de reanálisis de AppX en el directorio AppData del usuario.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

En este momento, Windows no proporciona una manera de obtener la información de destino de un punto de reanálisis de AppX. Las propiedades LinkTarget y LinkType del objeto filesystem están vacías.

Parámetros

-Attributes

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

Obtiene los archivos y las carpetas con los atributos especificados. Este parámetro es compatible con 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 Attributes . O bien, los parámetros Directory, File, Hidden, ReadOnly y System.

El parámetro Attributes admite las siguientes propiedades:

Archivar
Compressed
Device
Directorio
Cifrado
Oculto
IntegrityStream
Normal
NoScrubData
NotContentIndexed
Offline
ReadOnly
ReparsePoint
SparseFile
Sistema
Temporal

Para obtener una descripción de estos atributos, vea FileAttributes (enumeración).

Para combinar atributos, use los operadores siguientes:

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

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

Para los atributos comunes, use las abreviaturas siguientes:

D (Directorio)
H (Oculto)
R (Solo lectura)
S (Sistema)

Tipo:	FlagsExpression<T>[FileAttributes]
Valores aceptados:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CodeSigningCert

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Para obtener una lista de certificados que tienen Code Signing en su valor de propiedad EnhancedKeyUsageList , use el parámetro CodeSigningCert .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

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

Nota:

En un equipo Windows desde PowerShell o cmd.exe, puede mostrar una vista gráfica de una estructura de directorios con el comando tree.com .

Tipo:	UInt32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Directory

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

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.

Tipo:	SwitchParameter
Alias:	ad, d
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DnsName

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Especifica un nombre de dominio o un patrón de nombre para que coincida con la propiedad DNSNameList de los certificados que obtiene el cmdlet. El valor de este parámetro puede ser Unicode o ASCII. Los valores Punycode se convierten a Unicode. Se permiten caracteres comodín (*).

Este parámetro se introdujo en PowerShell 7.1

Tipo:	DnsNameRepresentation
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-DocumentEncryptionCert

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Para obtener una lista de certificados que tienen Document Encryption en su valor de propiedad EnhancedKeyUsageList , use el parámetro DocumentEncryptionCert .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Eku

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Especifica el texto o un patrón de texto que debe coincidir con la propiedad EnhancedKeyUsageList de los certificados que obtiene el cmdlet. Se permiten caracteres comodín (*). La propiedad EnhancedKeyUsageList contiene el nombre descriptivo y los campos OID de la EKU.

Este parámetro se introdujo en PowerShell 7.1

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-Exclude

Especifica una matriz de uno o varios patrones de cadena que se van a coincidir a medida que el cmdlet obtiene elementos secundarios. Cualquier elemento coincidente se excluye de la salida. Escriba un elemento o patrón de ruta de acceso, 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 del parámetro Path . 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.

Los parámetros Include y Exclude se pueden usar juntos. Sin embargo, las exclusiones se aplican después de las inclusiones, lo que puede afectar a la salida final.

Nota:

Los parámetros Include y Exclude no tienen ningún efecto cuando se usan con el parámetro LiteralPath . Esto se ha corregido en PowerShell 7.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-ExpiringInDays

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Especifica que el cmdlet solo debe devolver certificados que expiran en o antes del número de días especificado. Un valor de cero (0) obtiene certificados que han expirado.

Este parámetro se introdujo en PowerShell 7.1

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-File

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

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

Tipo:	SwitchParameter
Alias:	af
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Filter

Especifica un filtro para calificar el parámetro Path . El proveedor FileSystem es el único proveedor de PowerShell instalado que admite filtros. Los filtros son más eficaces que otros parámetros. El proveedor aplica el filtro 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. La API solo admite * caracteres comodín y ? .

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-FollowSymlink

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

De forma predeterminada, el Get-ChildItem cmdlet muestra vínculos simbólicos a directorios encontrados durante la recursividad, pero no se repite en ellos. Use el parámetro FollowSymlink para buscar los directorios que tienen como destino esos vínculos simbólicos. FollowSymlink es un parámetro dinámico y solo se admite en el proveedor FileSystem.

Este parámetro se introdujo en PowerShell 6.0.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-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 en función del proveedor. Para obtener más información, consulte about_Providers.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Hidden

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

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

Tipo:	SwitchParameter
Alias:	ah, h
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Include

Especifica una matriz de uno o varios patrones de cadena que se van a coincidir a medida que el cmdlet obtiene elementos secundarios. Cualquier elemento coincidente se incluye en la salida. 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.

Los parámetros Include y Exclude se pueden usar juntos. Sin embargo, las exclusiones se aplican después de las inclusiones, lo que puede afectar a la salida final.

Nota:

Los parámetros Include y Exclude no tienen ningún efecto cuando se usan con el parámetro LiteralPath . Esto se ha corregido en PowerShell 7.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 contiene caracteres de escape, escríbalos 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.

Nota:

Los parámetros Include y Exclude no tienen ningún efecto cuando se usan con el parámetro LiteralPath . Esto se ha corregido en PowerShell 7.

Tipo:	String[]
Alias:	PSPath
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Obtiene solo los nombres de los elementos de la ubicación. La salida es un objeto de cadena que se puede enviar por la canalización a otros comandos. Los nombres devueltos son relativos al valor del parámetro Path .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

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

Tipo:	String[]
Posición:	0
Valor predeterminado:	Current directory
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	True

-ReadOnly

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

Para obtener solo elementos de solo lectura, use el parámetro ReadOnly o la propiedad ReadOnly del parámetro Attributes.

Tipo:	SwitchParameter
Alias:	ar
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Recurse

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

Tipo:	SwitchParameter
Alias:	s
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SSLServerAuthentication

Nota:

Este parámetro solo está disponible en el proveedor de certificados.

Para obtener una lista de certificados que tienen Server Authentication en su valor de propiedad EnhancedKeyUsageList , use el parámetro SSLServerAuthentication .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-System

Nota:

Este parámetro solo está disponible en el proveedor FileSystem .

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

Tipo:	SwitchParameter
Alias:	as
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseTransaction

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

Tipo:	SwitchParameter
Alias:	usetx
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

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

Salidas

AliasInfo

El cmdlet genera este tipo al acceder a la Alias: unidad.

X509StoreLocation

X509Store

X509Certificate2

El cmdlet genera estos tipos al acceder a la Cert: unidad.

DictionaryEntry

El cmdlet genera este tipo al acceder a la Env: unidad.

DirectoryInfo

FileInfo

El cmdlet genera estos tipos al acceder a las unidades del sistema de archivos.

FunctionInfo

FilterInfo

El cmdlet genera estos tipos al acceder a las Function: unidades.

RegistryKey

El cmdlet genera este tipo al acceder a las unidades del Registro.

PSVariable

El cmdlet genera este tipo al acceder a las Variable: unidades.

WSManConfigContainerElement

WSManConfigLeafElement

El cmdlet genera estos tipos al acceder a las WSMan: unidades.

String

Cuando se usa el parámetro Name , este cmdlet devuelve los nombres de objeto como cadenas.

Notas

Windows PowerShell incluye los siguientes alias para Get-ChildItem:

ls
dir
gci

Get-ChildItem no obtiene elementos ocultos de forma predeterminada. Para obtener elementos ocultos, use el parámetro Force .

El Get-ChildItem 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.

Compartir a través de

Get-ChildItem

Sintaxis

Description

Ejemplos

Ejemplo 1: Obtener elementos secundarios de un directorio del sistema de archivos

Ejemplo 2: Obtener nombres de elementos secundarios en un directorio

Ejemplo 3: Obtener elementos secundarios en el directorio y subdirectorios actuales

Ejemplo 4: Obtener elementos secundarios mediante el parámetro Include

Ejemplo 5: Obtener elementos secundarios mediante el parámetro Exclude

Ejemplo 6: Obtención de las claves del Registro de un subárbol del Registro

Ejemplo 7: Obtención de todos los certificados con entidad de firma de código

Ejemplo 8: Obtener elementos mediante el parámetro Depth

Ejemplo 9: Obtención del destino del vínculo para un punto de unión

Ejemplo 10: Obtención del destino del vínculo para un punto de reanálisis de AppX

Parámetros

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

-UseTransaction

Entradas

Salidas

Notas

Vínculos relacionados

Recursos adicionales