Compartir a través de

Get-Item

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Obtiene el elemento en la ubicación especificada.

Sintaxis

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-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 a menos que use un carácter comodín ('*') para solicitar todo el contenido 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

Este comando 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

Este comando obtiene 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 comando 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 especificada

Este comando obtiene los elementos de la unidad C: . El carácter comodín ('*') representa todos los elementos del contenedor, no solo el contenedor.

En PowerShell, use un único asterisco ('') para obtener contenido, en lugar del tradicional ".". El formato se interpreta literalmente, por lo que ".*" no recuperaría directorios ni nombres de archivo sin un punto.

Get-Item C:\*

Ejemplo 5: Obtener una propiedad en el directorio especificado

Este comando obtiene la propiedad LastAccessTime del directorio "C:\Windows". lastAccessTime es solo una propiedad de 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

Este comando 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

Este comando obtiene elementos en el directorio de Windows con nombres que incluyen un punto ('.'), pero no comienzan por "w*". Este comando 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*"

Parámetros

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "User01" o "Domain01\User01", o escriba un objeto de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá una contraseña.

Advertencia

Este parámetro no es compatible con ningún proveedor instalado con Windows PowerShell.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 califica el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permiten 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".

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

-Filter

Especifica un filtro en el formato o idioma 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 cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.

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

-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, vea about_Providers. Incluso con el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 califica el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permiten 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".

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 al elemento. A diferencia del parámetro path de , el valor de LiteralPath se usa exactamente como se escribe. No se interpreta ningún carácter 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.

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

-Path

Especifica la ruta de acceso a un elemento. Este cmdlet obtiene el elemento en la ubicación especificada. Se permiten caracteres comodín. Este parámetro es obligatorio, pero el nombre del parámetro ("Path") 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.

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

-Stream

Obtiene la secuencia de archivos NTFS alternativa especificada del archivo. Escriba el nombre de la secuencia. Se admiten caracteres comodín. Para obtener todas las secuencias, use un asterisco (*). Este parámetro no es válido en carpetas.

Stream es un parámetro dinámico que el proveedor FileSystem agrega al cmdlet Get-Item. Este parámetro solo funciona en unidades del sistema de archivos.

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

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

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

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 los valores y los 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, vea about_Providers.