Get-Item
Ottiene l'elemento nella posizione specificata.
Sintassi
Path (Impostazione predefinita)
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>]
Descrizione
Il cmdlet Get-Item ottiene l'elemento alla posizione specificata.
Non ottiene il contenuto dell'elemento nella posizione, a meno che non si usi un carattere jolly ('*') per richiedere tutto il contenuto dell'elemento.
Questo cmdlet viene usato dai provider di PowerShell per spostarsi tra diversi tipi di archivi dati.
Esempio
Esempio 1: Recuperare la directory corrente
Questo comando ottiene la directory corrente. Il punto ('.') rappresenta l'elemento nella posizione corrente (non il relativo contenuto).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Esempio 2: Ottenere tutti gli elementi nella directory corrente
Questo comando ottiene tutti gli elementi nella directory corrente. Il carattere jolly ('*') rappresenta tutto il contenuto dell'elemento corrente.
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
Esempio 3: Ottenere la directory corrente di un'unità
Questo comando ottiene la directory corrente dell'unità C: . L'oggetto recuperato rappresenta solo la directory, non il relativo contenuto.
Get-Item C:\
Esempio 4: Recuperare gli elementi sull'unità specificata
Questo comando ottiene gli elementi nell'unità C: . Il carattere jolly ('*') rappresenta tutti gli elementi nel contenitore, non solo il contenitore.
In PowerShell usare un singolo asterisco ('') per ottenere il contenuto, anziché il tradizionale ".". Il formato viene interpretato letteralmente, quindi ".*" non recupererebbe directory o nomi di file senza un punto.
Get-Item C:\*
Esempio 5: Ottenere una proprietà nella directory specificata
Questo comando ottiene la proprietà LastAccessTime della directory "C:\Windows".
LastAccessTime è solo una proprietà delle directory del file system.
Per visualizzare tutte le proprietà di una directory, digitare (Get-Item \<directory-name\>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
Esempio 6: Visualizzare il contenuto di una chiave del Registro di sistema
Questo comando mostra il contenuto della chiave del Registro di sistema Microsoft.PowerShell.
È possibile usare questo cmdlet con il provider del Registro di sistema di PowerShell per ottenere chiavi e sottochiavi del Registro di sistema, ma è necessario usare il cmdlet Get-ItemProperty per ottenere i valori e i dati del Registro di sistema.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
Esempio 7: Ottenere gli elementi in una directory che hanno un'esclusione
Questo comando ottiene gli elementi nella directory di Windows con nomi che includono un punto ('.'), ma non iniziano con "w*". Questo comando funziona solo quando il percorso include un carattere jolly ('*') per specificare il contenuto dell'elemento.
Get-Item c:\Windows\*.* -Exclude "w*"
Parametri
-Credential
Specifica un account utente autorizzato a eseguire questa azione. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio "User01" o "Domain01\User01" oppure immettere un oggetto PSCredential, ad esempio quello generato dal cmdlet Get-Credential.
Se si digita un nome utente, viene richiesta una password.
Avvertimento
Questo parametro non è supportato da alcun provider installato con Windows PowerShell.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | Current user |
| 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à: | True |
| Valore dagli argomenti rimanenti: | False |
-Exclude
Specifica, come array di stringhe, uno o più elementi che questo cmdlet esclude durante l'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 exclude
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 |
-Filter
Specifica un filtro nel formato o nella lingua del provider. Il valore di questo parametro qualifica il parametro Path.
La sintassi del filtro, incluso l'uso di caratteri jolly, dipende dal provider. 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.
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 |
-Force
Indica che questo cmdlet ottiene elementi a cui non è possibile accedere in altro modo, ad esempio elementi nascosti. L'implementazione varia da provider a provider. Per altre informazioni, consultare about_Providers. Anche usando il parametro Force, il cmdlet non può eseguire l'override delle restrizioni di sicurezza.
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 |
-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
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 dell'elemento. A differenza del parametro Path, il valore di LiteralPath viene usato 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath |
Set di parametri
LiteralPath
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Path
Specifica il percorso di un elemento. Questo cmdlet ottiene l'elemento nella posizione specificata. Sono consentiti i metacaratteri. Questo parametro è obbligatorio, ma il nome del parametro ("Path") è facoltativo.
Usare un punto ('.') per specificare il percorso corrente. Usare il carattere jolly ('*') per specificare tutti gli elementi nella posizione corrente.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
Path
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Stream
Ottiene il flusso di file NTFS alternativo specificato dal file. Immettere il nome del flusso. Sono supportati caratteri jolly. Per ottenere tutti i flussi, usare un asterisco (*). Questo parametro non è valido nelle cartelle.
Stream è un parametro dinamico aggiunto dal provider FileSystem al cmdlet Get-Item. Questo parametro funziona solo nelle unità del sistema di file.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | No alternate file streams |
| 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 |
-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 inviare tramite pipe una stringa contenente un percorso a questo cmdlet.
Output
Object
Questo cmdlet restituisce gli oggetti che ottiene. Il tipo è determinato dal tipo di oggetti nel percorso.
Note
Questo cmdlet non dispone di un parametro Recurse, perché ottiene solo un elemento, non il relativo contenuto.
Per ottenere il contenuto di un elemento in modo ricorsivo, usare Get-ChildItem.
Per spostarsi nel Registro di sistema, usare questo cmdlet per ottenere le chiavi del Registro di sistema e il Get-ItemProperty per ottenere i valori e i dati del Registro di sistema.
I valori del Registro di sistema vengono considerati proprietà della chiave del Registro di sistema.
Questo cmdlet è 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.