Condividi tramite

Get-ChildItem

Modulo:
Microsoft.PowerShell.Management Module

Ottiene gli elementi e i sottoelementi in una o più posizioni specificate.

Sintassi

Items (Impostazione predefinita) 

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

LiteralItems 

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

Descrizione

Il cmdlet Get-ChildItem ottiene gli elementi in una o più posizioni specificate. Se l'elemento è un contenitore, ottiene gli elementi all'interno del contenitore, noti come elementi figlio. È possibile usare il parametro Recurse per ottenere elementi in tutti i contenitori figlio e usare il parametro Depth per limitare il numero di livelli da ripetere.

Get-ChildItem Non visualizza directory vuote. Quando un Get-ChildItem comando include i parametri Depth o Recurse , le directory vuote non vengono incluse nell'output.

Le posizioni vengono esposte a Get-ChildItem dai provider di PowerShell. Un percorso può essere una directory del file system, un hive del Registro di sistema o un archivio di certificati. Per altre informazioni, consultare about_Providers.

Parametri

-Attributes

Ottiene file e cartelle con gli attributi specificati. Questo parametro supporta tutti gli attributi e consente di specificare combinazioni complesse di attributi.

Ad esempio, per ottenere file non di sistema (non directory) crittografati o compressi, digitare:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Per trovare file e cartelle con attributi di uso comune, usare il parametro attributi. In alternativa, i parametri Directory, File, Hidden, ReadOnlye System.

Il parametro Attributes supporta le proprietà seguenti:

  • archivio
  • compresso
  • Dispositivo
  • Elenco
  • Crittografata
  • Nascosti
  • IntegrityStream
  • Normale
  • NoScrubData
  • NonIndicizzatoContenuto
  • Offline
  • Sola lettura
  • PuntoDiRielaborazione
  • SparseFile
  • Sistema
  • Temporanei

Per una descrizione di questi attributi, vedere l'enumerazione FileAttributes.

Per combinare gli attributi, usare gli operatori seguenti:

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

Non utilizzare spazi tra un operatore e il relativo attributo. Gli spazi vengono accettati dopo le virgole.

Per gli attributi comuni, usare le abbreviazioni seguenti:

  • D (Directory)
  • H (nascosto)
  • R (sola lettura)
  • S (Sistema)

Proprietà dei parametri

Tipo:

FlagsExpression<T>[FileAttributes]

Valore predefinito:None
Valori accettati:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Depth

Questo parametro è stato aggiunto in PowerShell 5.0 e consente di controllare la profondità della ricorsione. Per impostazione predefinita, Get-ChildItem visualizza il contenuto della directory padre. Il parametro Depth determina il numero di livelli di sottodirectory inclusi nella ricorsione e visualizza il contenuto.

Ad esempio, Depth 2 include la directory del parametro Path, il primo livello di sottodirectory e il secondo livello di sottodirectory. Per impostazione predefinita, i nomi delle directory e i nomi dei file sono inclusi nell'output.

Annotazioni

In un computer Windows da PowerShell o cmd.exe, è possibile visualizzare una vista grafica di una struttura di directory con il comando tree.com.

Proprietà dei parametri

Tipo:UInt32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Directory

Per ottenere un elenco di directory, utilizzare il parametro Directory o il parametro Attributes con la proprietà Directory. È possibile usare il parametro Recurse con Directory.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:annuncio pubblicitario, d

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Exclude

Specifica, come matrice di stringhe, una proprietà o una proprietà che questo cmdlet esclude dall'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio *.txt o A*. I caratteri jolly vengono accettati.

Un asterisco finale (*) nel parametro Path è facoltativo. Ad esempio, -Path C:\Test\Logs o -Path C:\Test\Logs\*. Se viene incluso un asterisco finale (*), il comando ricorre nelle sottodirectory del parametro Path . Senza l'asterisco (*), viene visualizzato il contenuto del parametro Path. Altri dettagli sono inclusi nell'esempio 5 e nella sezione Note.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-File

Per ottenere un elenco di file, usare il parametro file. È possibile usare il parametro Recurse con File.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:af

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

Specifica un filtro per qualificare il parametro Path. Il provider di FileSystem è l'unico provider di PowerShell installato che supporta l'utilizzo dei filtri. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica quando il cmdlet ottiene gli oggetti anziché filtrare gli oggetti dopo il recupero. La stringa di filtro viene passata all'API .NET per enumerare i file. L'API supporta * solo i ? caratteri jolly.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Consente al cmdlet di ottenere elementi che altrimenti non sarebbero accessibili all'utente, ad esempio i file nascosti o di sistema. Il parametro Force non sostituisce le restrizioni di sicurezza. L'implementazione varia tra i provider. Per altre informazioni, consultare about_Providers.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Hidden

Per ottenere solo elementi nascosti, utilizzare il parametro Hidden o il parametro Attributes con la proprietà Hidden. Per impostazione predefinita, Get-ChildItem non visualizza gli elementi nascosti. Usare il parametro Force per ottenere elementi nascosti.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ah, h

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Include

Specifica, sotto forma di matrice di stringhe, un elemento o elementi che questo cmdlet include nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio "*.txt". Sono consentiti caratteri jolly. Il parametro Include è efficace solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, dove il carattere jolly specifica il contenuto della directory C:\Windows.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LiteralPath

Specifica un percorso per una o più posizioni. Il valore di LiteralPath viene utilizzato esattamente come viene digitato. Nessun carattere viene interpretato come metacaratteri. Se il percorso include caratteri di escape, racchiudilo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Per altre informazioni, vedere about_Quoting_Rules.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PSPath

Set di parametri

LiteralItems
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Ottiene solo i nomi degli elementi nella posizione. L'output è un oggetto stringa che può essere inviato lungo la pipeline verso altri comandi. Sono consentiti i metacaratteri.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Specifica un percorso per una o più posizioni. I caratteri jolly vengono accettati. Il percorso predefinito è la directory corrente (.).

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:Current directory
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Items
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ReadOnly

Per ottenere solo elementi di sola lettura, utilizzare il parametro ReadOnly o il parametro Attributes o la proprietà ReadOnly.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Ar

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Recurse

Ottiene gli elementi nelle posizioni specificate e in tutti gli elementi figli delle stesse posizioni.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:s

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-System

Ottiene solo file di sistema e directory. Per ottenere solo file e cartelle di sistema, utilizzare il parametro Sistema o il parametro Attributi o la proprietà Sistema.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:come

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:usetx

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

È possibile reindirizzare una stringa che contiene un percorso a Get-ChildItem.

Output

Object

Il tipo di oggetto restituito Get-ChildItem è determinato dagli oggetti nel percorso dell'unità del provider.

String

Se si utilizza il parametro Name , Get-ChildItem restituisce i nomi degli oggetti come stringhe.

Note

  • È possibile fare riferimento ai Get-ChildItem relativi alias incorporati, ls, dir, e gci. Per altre informazioni, vedere about_Aliases.
  • Get-ChildItem Per impostazione predefinita, non ottiene gli elementi nascosti. Per ottenere elementi nascosti, usa il parametro Force.
  • Il cmdlet Get-ChildItem è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, consultare about_Providers.