Ottiene l'elemento nella posizione specificata.

Sintassi

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

Descrizione

Il cmdlet Get-Item ottiene l'elemento nella posizione specificata. Non ottiene il contenuto dell'elemento nella posizione, a meno che non si utilizzi un carattere jolly (*) per richiedere tutto il contenuto dell'elemento.

Il cmdlet Get-Item viene utilizzato dai provider Windows PowerShell per consentire l'esplorazione tra diversi tipi di archivi dati.

Parametri

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.

Questo parametro non è supportato dai provider installati con Windows PowerShell.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Exclude <string[]>

Omette gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Il parametro Exclude ha effetto 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.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Filter <string>

Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Force

Consente al cmdlet di ottenere elementi altrimenti inaccessibili, ad esempio elementi nascosti. L'implementazione varia a seconda del provider. Per ulteriori informazioni, vedere about_Providers. Quando si utilizza il parametro Force, il cmdlet non può ignorare le limitazioni di sicurezza.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Include <string[]>

Recupera unicamente gli elementi specificati. Il valore di questo parametro qualifica il parametro Path. Immettere un criterio o un elemento del percorso, ad esempio "*.txt". È consentito l'utilizzo di caratteri jolly.

Il parametro Include ha effetto 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.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-LiteralPath <string[]>

Specifica un percorso dell'elemento. A differenza di Path, il valore di LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Path <string[]>

Specifica il percorso di un elemento. Get-Item ottiene l'elemento nel percorso specificato. È consentito l'utilizzo di caratteri jolly. Questo parametro è obbligatorio, ma il nome del parametro ("Path") è facoltativo.

Utilizzare un punto (.) per specificare la posizione corrente. Utilizzare il carattere jolly (*) per specificare tutti gli elementi nella posizione corrente.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

Accettare caratteri jolly?

false

-UseTransaction

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

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

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

Output

Object

Get-Item restituisce gli oggetti ottenuti. Il tipo è determinato dal tipo di oggetti nel percorso.

Note

È inoltre possibile fare riferimento a Get-Item tramite il relativo alias predefinito "gi". Per ulteriori informazioni, vedere about_Aliases.

Get-Item non prevede un parametro Recurse, perché ottiene solo un elemento, non il relativo contenuto. Per ottenere il contenuto di un elemento in modalità ricorsiva, utilizzare Get-ChildItem.

Per esplorare il Registro di sistema, utilizzare Get-Item per ottenere le chiavi del Registro di sistema e Get-ItemProperty per ottenere i valori e i dati del Registro di sistema. I valori del Registro di sistema sono considerati proprietà della chiave del Registro di sistema.

Il cmdlet Get-Item è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PsProvider". Per ulteriori informazioni, vedere about_Providers.

Esempio 1

C:\PS>get-item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Descrizione
-----------
Con questo comando viene ottenuta la directory corrente. Il punto (.) rappresenta l'elemento nella posizione corrente, non il contenuto.






Esempio 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

Descrizione
-----------
Con questo comando si ottengono tutti gli elementi nella directory corrente. Il carattere jolly (*) rappresenta tutto il contenuto dell'elemento corrente.






Esempio 3

C:\PS>get-item C:\

Descrizione
-----------
Con questo comando viene ottenuta la directory corrente dell'unità C: L'oggetto recuperato rappresenta solo la directory, non il contenuto.






Esempio 4

C:\PS>get-item C:\*

Descrizione
-----------
Con questo comando vengono ottenuti gli elementi nell'unità C:. Il carattere jolly (*) rappresenta tutti gli elementi nel contenitore, non solo il contenitore.

In Windows PowerShell utilizzare un asterisco singolo (*) per ottenere il contenuto, anziché la forma standard "*.*". Il formato viene interpretato in modo letterale, pertanto "*.*" non consentirebbe il recupero delle directory o dei nomi di file senza punto.






Esempio 5

C:\PS>(get-item C:\Windows).LastAccessTime

Descrizione
-----------
Con questo comando viene ottenuta la proprietà LastAccessTime della directory C:\Windows. LastAccessTime è solo una proprietà delle directory del file system. Per vedere tutte le proprietà di una directory, digitare "(Get-Item <nome-directory>) | Get-Member".






Esempio 6

C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*

Descrizione
-----------
Con questo comando viene mostrato il contenuto della chiave del Registro di sistema Microsoft.PowerShell. È possibile utilizzare Get-Item con il provider Registry di Windows PowerShell per ottenere le chiavi e le sottochiavi del Registro di sistema, ma è necessario utilizzare Get-ItemProperty per ottenere i valori e i dati del Registro di sistema.






Esempio 7

C:\PS>get-item c:\Windows\* -include *.* -exclude w*

Descrizione
-----------
Con questo comando vengono ottenuti gli elementi nella directory Windows il cui nome contiene un punto (.), ma non inizia con w*. Questo comando funziona solo quando il percorso include un carattere jolly (*) per specificare il contenuto dell'elemento.






Vedere anche




Argomenti della Guida