Get-Item
Obtiene el elemento en la ubicación especificada.
Sintaxis
Path (valor predeterminado)
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
Description
El cmdlet Get-Item obtiene el elemento en la ubicación especificada. No obtiene el contenido del elemento en la ubicación específica a menos que use un carácter comodín (*) para solicitar todos los contenidos del elemento.
Los proveedores de PowerShell usan este cmdlet para navegar por diferentes tipos de almacenes de datos.
Ejemplos
Ejemplo 1: Obtener el directorio actual
En este ejemplo se obtiene el directorio actual. El punto ('.') representa el elemento en la ubicación actual (no su contenido).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Ejemplo 2: Obtener todos los elementos del directorio actual
En este ejemplo se obtienen todos los elementos del directorio actual. El carácter comodín (*) representa todo el contenido del elemento actual.
Get-Item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
Ejemplo 3: Obtener el directorio actual de una unidad
Este ejemplo obtiene el directorio actual de la unidad C:. El objeto que se recupera representa solo el directorio, no su contenido.
Get-Item C:
Ejemplo 4: Obtener elementos en la unidad de disco especificada
Este ejemplo obtiene los elementos de la unidad C:. El carácter comodín (*) representa todos los elementos del contenedor, no solo el contenedor.
Get-Item C:\*
En PowerShell, use un único asterisco (*) para obtener contenido, en lugar de la *.*tradicional . El formato se interpreta literalmente, por lo que *.* no recuperaría directorios ni nombres de archivo sin un punto.
Ejemplo 5: Obtener una propiedad en el directorio especificado
En este ejemplo se obtiene la propiedad LastAccessTime del directorio C:\Windows.
LastAccessTime es solo una propiedad de los directorios del sistema de archivos. Para ver todas las propiedades de un directorio, escriba (Get-Item <directory-name>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
Ejemplo 6: Mostrar el contenido de una clave del Registro
En este ejemplo se muestra el contenido de la clave del Registro de Microsoft.PowerShell. Puede usar este cmdlet con el proveedor del Registro de PowerShell para obtener claves del Registro y subclaves, pero debe usar el cmdlet Get-ItemProperty para obtener los valores y los datos del Registro.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
Ejemplo 7: Obtener elementos de un directorio que tienen una exclusión
En este ejemplo se obtienen elementos del directorio de Windows con nombres que incluyen un punto (.), pero no comienzan por w*. Este ejemplo solo funciona cuando la ruta de acceso incluye un carácter comodín (*) para especificar el contenido del elemento.
Get-Item C:\Windows\*.* -Exclude "w*"
Ejemplo 8: Obtención de información sobre enlaces duros
En PowerShell 6.2, se agregó una vista alternativa para obtener información de vínculo físico. Para obtener la información del enlace duro, canalice la salida a Format-Table -View childrenWithHardlink.
Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink
Directory: C:\Windows\System32
Mode LastWriteTime Length Name
---- ------------- ------ ----
la--- 5/12/2021 7:40 AM 10848576 ntoskrnl.exe
La propiedad Mode identifica el hardlink por el l en la---.
Ejemplo 9: Salida para sistemas operativos que no son Windows
En PowerShell 7.1 en sistemas Unix, el cmdlet Get-Item proporciona una salida similar a Unix:
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 Users
Las nuevas propiedades que forman parte de la salida son:
- UnixMode son los permisos de archivo tal como se representan en un sistema Unix.
- usuario es el propietario del archivo
- grupo es el propietario del grupo
- Tamaño es el tamaño del archivo o directorio tal como se representa en un sistema Unix.
Nota:
Esta característica se ha movido de experimental a estándar en PowerShell 7.1.
Parámetros
-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.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | Current user |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Exclude
Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye 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 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 directorio C:\Windows.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Especifica un filtro para calificar el parámetro Path. El proveedor de 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 ?.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Indica que este cmdlet obtiene elementos a los que no se puede tener acceso de otro modo, como elementos ocultos. La implementación varía de proveedor a proveedor. Para obtener más información, consulte about_Providers. Incluso con el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 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
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LiteralPath
Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa exactamente 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
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSPath, LP |
Conjuntos de parámetros
LiteralPath
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Path
Especifica la ruta de acceso a un elemento. Este cmdlet obtiene el elemento en la ubicación especificada. Se permite el uso de caracteres comodín. Este parámetro es obligatorio, pero el nombre del parámetro Ruta de acceso es opcional.
Use un punto (.) para especificar la ubicación actual. Use el carácter comodín (*) para especificar todos los elementos de la ubicación actual.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
Path
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Stream
Nota:
Este parámetro solo está disponible en Windows.
Obtiene la secuencia de archivos NTFS alternativa especificada del archivo. Escriba el nombre de la secuencia. Se admiten comodines. Para obtener todos los flujos, use un asterisco (*). Este parámetro no es válido en carpetas.
Stream es un parámetro dinámico que el proveedor de FileSystem agrega al cmdlet Get-Item.
Este parámetro solo funciona en unidades del sistema de archivos.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | No alternate file streams |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
String
Puede enviar una cadena que contenga una ruta de acceso a este cmdlet.
Salidas
Object
Este cmdlet devuelve los objetos que obtiene. El tipo viene determinado por el tipo de objetos de la ruta de acceso.
Notas
Este cmdlet no tiene un parámetro Recurse, ya que solo obtiene un elemento, no su contenido.
Para obtener el contenido de un elemento de forma recursiva, use Get-ChildItem.
Para navegar por el registro, use este cmdlet para obtener las claves del registro y el Get-ItemProperty para obtener valores y datos del registro. Los valores del Registro se consideran propiedades de la clave del Registro.
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.