Condividi tramite

Get-ItemProperty

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Ottiene le proprietà di un elemento specificato.

Sintassi

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-ItemProperty ottiene le proprietà degli elementi specificati. Ad esempio, è possibile usare questo cmdlet per ottenere il valore della proprietà LastAccessTime di un oggetto file. È anche possibile usare questo cmdlet per visualizzare le voci del Registro di sistema e i relativi valori.

Esempio

Esempio 1: Ottenere informazioni su una directory specifica

Questo comando ottiene informazioni sulla directory C:\Windows.

Get-ItemProperty C:\Windows

Esempio 2: Ottenere le proprietà di un file specifico

Questo comando ottiene le proprietà del file C:\Test\Weather.xls. Il risultato viene inviato tramite pipe al cmdlet Format-List per visualizzare l'output come elenco.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Esempio 3: Ottenere il nome del valore e i dati di una voce del Registro di sistema in una sottochiave del Registro di sistema

Questo comando ottiene il nome del valore e i dati della voce del Registro di sistema ProgramFilesDir nella sottochiave del Registro di sistema CurrentVersion. Il Percorso specifica la sottochiave e il parametro Nome specifica il nome del valore della voce.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Nota

Questo comando richiede che sia presente un'unità di PowerShell denominata HKLM: mappata all'hive HKEY_LOCAL_MACHINE del Registro di sistema.

Un'unità con tale nome e mapping è disponibile in PowerShell per impostazione predefinita. In alternativa, è possibile specificare il percorso di questa sottochiave del Registro di sistema usando il percorso alternativo seguente che inizia con il nome del provider seguito da due punti:

Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

Esempio 4: Ottenere i nomi dei valori e i dati delle voci del Registro di sistema in una chiave del Registro di sistema

Questo comando ottiene i nomi dei valori e i dati delle voci del Registro di sistema nella chiave del Registro di sistema PowerShellEngine. I risultati sono visualizzati nell'output di esempio seguente.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

Parametri

-Credential

Nota

Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali quando si esegue questo cmdlet, usare Invoke-Command.

Tipo:PSCredential
Posizione:Named
Valore predefinito:Current user
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Exclude

Specifica, come matrice di stringhe, un elemento o elementi esclusi dal cmdlet 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 Exclude è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Filter

Specifica un filtro per qualificare il parametro Path. Il provider di FileSystem è l'unico provider di PowerShell installato che supporta l'uso dei filtri. È possibile trovare la sintassi per il linguaggio di filtro FileSystem in about_Wildcards. 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Include

Specifica, come matrice di stringhe, un elemento o elementi inclusi nel cmdlet 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 Includi è effettivo solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, in cui il carattere jolly specifica il contenuto della directory C:\Windows.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-LiteralPath

Specifica un percorso per una o più posizioni. Il valore di LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come caratteri jolly. Se il percorso include caratteri di escape, racchiuderlo 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.

Tipo:String[]
Alias:PSPath, LP
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome della proprietà o delle proprietà da recuperare. Sono consentiti caratteri jolly.

Tipo:String[]
Alias:PSProperty
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Path

Specifica il percorso dell'elemento o degli elementi. Sono consentiti caratteri jolly.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

Input

String

È possibile inviare tramite pipe una stringa contenente un percorso a questo cmdlet.

Output

Boolean

String

DateTime

FileInfo

DirectoryInfo

Questo cmdlet restituisce un oggetto per ogni proprietà dell'elemento che ottiene. Il tipo di oggetto dipende dall'oggetto recuperato. Ad esempio, in un'unità del file system, potrebbe restituire un file o una cartella.

Note

PowerShell include gli alias seguenti per Get-ItemProperty:

  • Tutte le piattaforme:
    • gp

Il cmdlet Get-ItemProperty è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, vedere about_Providers.