Get-Item

Sintaxis

Path (valor predeterminado)

Get-Item
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-Stream <String[]>]
    [<CommonParameters>]

LiteralPath

Get-Item
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-Stream <String[]>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Obtener el directorio actual

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

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

Get-Item C:\

Ejemplo 4: Obtener elementos en la unidad de disco especificada

Get-Item C:\*

Ejemplo 5: Obtener una propiedad en el directorio especificado

(Get-Item C:\Windows).LastAccessTime

Ejemplo 6: Mostrar el contenido de una clave del Registro

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Ejemplo 7: Obtener elementos de un directorio que tienen una exclusión

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.

Propiedades de parámetro

Conjuntos de parámetros

-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 o patrón de ruta de acceso, 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

Conjuntos de parámetros

-Filter

Especifica un filtro en el formato o idioma del proveedor. El valor de este parámetro define 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.

Propiedades de parámetro

Conjuntos de parámetros

-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

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 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 directorio "C:\Windows".

Propiedades de parámetro

Conjuntos de parámetros

-LiteralPath

Especifica una ruta de acceso al elemento. A diferencia del parámetro Path, 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 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.

Propiedades de parámetro

Conjuntos de parámetros

-Path

Especifica la ruta de acceso a un elemento. Este cmdlet obtiene el elemento en la ubicación especificada. Se permiten los 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.

Propiedades de parámetro

Conjuntos de parámetros

-Stream

Obtiene la secuencia de archivos NTFS alternativa especificada del archivo. Escriba el nombre de la secuencia. Se admiten comodines. 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.

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

Notas

Vínculos relacionados

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider