Get-Item
Obtiene el elemento de la ubicación especificada.
Sintaxis
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-Item obtiene el elemento de la ubicación especificada. No obtiene el contenido del elemento de la ubicación especificada, a menos que se use un carácter comodín (*) para solicitar todo el contenido del elemento.
Los proveedores de Windows PowerShell usan el cmdlet Get-Item para permitir navegar por distintos tipos de almacenes de datos.
Parámetros
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-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.
El parámetro Exclude sólo 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.
¿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? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Force
Permite al cmdlet obtener elementos a los que no se puede tener acceso de ningún otro modo, como elementos ocultos. 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 contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del directorio C:\Windows.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica una ruta de acceso al elemento. 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 |
-Path <string[]>
Especifica la ruta de acceso a un elemento. Get-Item obtiene el elemento de la ubicación especificada. Se permite el uso de 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.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿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-Item. |
Salidas |
Object Get-Item devuelve los objetos que obtiene. El tipo está determinado por el tipo de objetos en la ruta de acceso. |
Notas
También puede hacer referencia a Get-Item mediante su alias integrado, "gi". Para obtener más información, vea about_Aliases.
Get-Item no tiene un parámetro Recurse, ya que sólo 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 Get-Item para obtener claves del Registro y Get-ItemProperty para obtener valores y datos del Registro. Se considera que los valores del Registro son propiedades de la clave del Registro.
El cmdlet Get-Item 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-item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Descripción
-----------
Este comando obtiene el directorio actual. El punto (.) representa el elemento de la ubicación actual (no su contenido).
Ejemplo 2
C:\PS>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
Descripción
-----------
Este comando obtiene todos los elementos del directorio actual. El carácter comodín (*) representa todo el contenido del elemento actual.
Ejemplo 3
C:\PS>get-item C:\
Descripción
-----------
Este comando obtiene el directorio actual de la unidad C:. El objeto recuperado representa únicamente el directorio, no su contenido.
Ejemplo 4
C:\PS>get-item C:\*
Descripción
-----------
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 Windows PowerShell se debe usar un solo asterisco (*) para obtener el contenido, en lugar del tradicional "*.*". El formato se interpreta literalmente, por lo que "*.*" no recuperará los directorios ni los nombres de archivo que no contengan un punto.
Ejemplo 5
C:\PS>(get-item C:\Windows).LastAccessTime
Descripción
-----------
Este comando obtiene la propiedad LastAccessTime del directorio C:\Windows. LastAccessTime es sólo una de las propiedades de los directorios del sistema de archivos. Para ver todas las propiedades de un directorio, escriba "(Get-Item <nombre-directorio>) | Get-Member".
Ejemplo 6
C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*
Descripción
-----------
Este comando muestra el contenido de la clave Microsoft.PowerShell del Registro. Puede usar Get-Item con el proveedor Registry de Windows PowerShell para obtener las claves y subclaves del Registro, pero debe usar Get-ItemProperty para obtener los valores y los datos del Registro.
Ejemplo 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w*
Descripción
-----------
Este comando obtiene elementos del directorio de Windows cuyo nombre incluya un punto (.) y que no empiecen por w*. Este comando sólo funciona si la ruta incluye un carácter comodín (*) para especificar el contenido del elemento.
Vea también
Conceptos
about_Providers
Clear-Item
Copy-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item