Get-ItemProperty
Ottiene le proprietà di un elemento specificato.
Sintassi
Path (Impostazione predefinita)
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Get-ItemProperty
[[-Name] <String[]>]
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Descrizione
Il cmdlet Get-ItemProperty ottiene le proprietà degli elementi specificati.
Ad esempio, è possibile utilizzare 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: Visualizzare il nome del valore e i dati delle voci del Registro di sistema in una sottochiave del Registro di sistema
Questo comando visualizza il valore, il nome e i dati di ciascuna delle voci del Registro di sistema contenute nella sottochiave del Registro di sistema "CurrentVersion".
Si noti che il comando richiede che sia presente un'unità 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:
"Registro::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Esempio 4: 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 valore, il nome e i dati della voce del Registro di sistema "ProgramFilesDir" nella sottochiave del Registro di sistema "CurrentVersion". Il comando utilizza il parametro Path per specificare la sottochiave e il parametro Name per specificare il nome del valore della voce.
Il comando usa un segno di trincea o un accento grave ('), il carattere di continuazione di PowerShell, per continuare il comando sulla seconda riga.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Esempio 5: 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
Esempio 6: Ottenere, formattare e visualizzare i risultati dei valori e dei dati del Registro di sistema
In questo esempio viene illustrato come formattare l'output di un Get-ItemProperty comando in un elenco per semplificare la visualizzazione dei valori e dei dati del Registro di sistema e l'interpretazione dei risultati.
Il primo comando usa il Get-ItemProperty cmdlet per ottenere le voci del Registro di sistema nella sottochiave Microsoft.PowerShell .
Questa sottochiave archivia le opzioni per la shell predefinita per PowerShell.
I risultati sono visualizzati nell'output di esempio seguente.
L'output mostra che sono presenti due voci del Registro di sistema, "Path" e "ExecutionPolicy". Quando una chiave del Registro di sistema contiene meno di cinque voci, per impostazione predefinita viene visualizzata in una tabella, ma spesso è più facile visualizzarla in un elenco.
Il secondo comando utilizza lo stesso Get-ItemProperty comando.
Tuttavia, questa volta, il comando usa un operatore pipeline (|) per inviare i risultati del comando al Format-List cmdlet.
Il Format-List comando utilizza il parametro Property con un valore di '*' (all) per visualizzare tutte le proprietà degli oggetti in un elenco.
I risultati sono visualizzati nell'output di esempio seguente.
La visualizzazione risultante mostra le voci del Registro di sistema "Path" e "ExecutionPolicy", insieme a diverse proprietà meno familiari dell'oggetto chiave del Registro di sistema. Le altre proprietà, precedute da PS, sono proprietà degli oggetti personalizzati di PowerShell, ad esempio gli oggetti che rappresentano le chiavi del Registro di sistema.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName : Microsoft.PowerShell
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
Path : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned
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 matrice di stringhe, un elemento o elementi esclusi dal cmdlet dall'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.
Proprietà dei parametri
| Tipo: | String[] |
| 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 |
-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 |
-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.
Proprietà dei parametri
| Tipo: | String[] |
| 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 |
-LiteralPath
Specifica il percorso alla posizione attuale della proprietà. 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 |
-Name
Specifica il nome della proprietà o delle proprietà da recuperare.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSProperty |
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 |
-Path
Specifica il percorso dell'elemento o degli elementi.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| 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 |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere 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-ItemProperty.
Output
System.Boolean, System.String, System.DateTime
Get-ItemProperty Restituisce un oggetto per ogni proprietà dell'elemento ottenuta.
Il tipo di oggetto dipende dall'oggetto recuperato.
Ad esempio, in un'unità del file system, potrebbe restituire un file o una cartella.
Note
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 ulteriori informazioni, vedere about_Providers.