Ottiene le proprietà di un elemento specificato.
Sintassi
Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>] Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Descrizione
Con il cmdlet Get-ItemProperty vengono ottenute le proprietà di uno o elementi specificati. Ad esempio, è possibile utilizzare Get-ItemProperty per ottenere il valore della proprietà LastAccessTime di un oggetto file su true. È anche possibile utilizzare Get-ItemProperty per visualizzare le voci del Registro di sistema e i loro valori.
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. È consentito l'utilizzo di caratteri jolly.
|
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 |
-Include <string[]>
Include gli elementi specificati.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-LiteralPath <string[]>
Specifica un percorso della proprietà dell'elemento. 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 |
-Name <string[]>
Specifica il nome della proprietà o delle proprietà da recuperare.
|
Obbligatorio? |
false |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica il percorso dell'elemento o degli elementi.
|
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-ItemProperty. |
|
Output |
Object Get-ItemProperty restituisce un oggetto per ogni proprietà dell'elemento ottenuta. Il tipo di oggetto dipende dall'oggetto recuperato. |
Note
Il cmdlet Get-ItemProperty è 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-itemproperty C:\Windows Descrizione ----------- Con questo comando vengono ottenute informazioni relative alla directory C:\Windows.
Esempio 2
C:\PS>get-itemproperty C:\Test\Weather.xls | format-list Descrizione ----------- Con questo comando vengono ottenute le proprietà del file C:\Test\Weather.xls. Il risultato viene reindirizzato al cmdlet Format-List per visualizzare l'output come elenco.
Esempio 3
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion Descrizione ----------- Con questo comando vengono visualizzati il nome del valore e i dati di ogni voce del Registro di sistema contenuta nella sottochiave CurrentVersion. Si noti che il comando richiede la presenza di un'unità di Windows PowerShell denominata HKLM: di cui viene eseguito il mapping all'hive HKEY_LOCAL_MACHINE del Registro di sistema. Un'unità con questo nome e questo mapping è disponibile per impostazione predefinita in Windows PowerShell. In alternativa, è possibile specificare il percorso di questa sottochiave del Registro di sistema utilizzando il percorso alternativo seguente che inizia con il nome del provider seguito dai due punti: Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.
Esempio 4
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion ` -name "ProgramFilesDir" Descrizione ----------- Con questo comando vengono ottenuti il nome del valore e i dati della voce del Registro di sistema ProgramFilesDir contenuta nella sottochiave CurrentVersion. Nel comando viene utilizzato il parametro Path per specificare la sottochiave e il parametro Name per specificare il nome del valore della voce.
Esempio 5
C:\PS>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=31bf3856ad
364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Descrizione
-----------
Con questo comando vengono ottenuti i nomi del valore e i dati delle voci del Registro di sistema nella chiave PowerShellEngine. I risultati vengono illustrati nell'esempio di output seguente.
Esempio 6
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
C:\PS>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
Descrizione
-----------
In questo esempio viene illustrato come formattare l'output di un comando Get-ItemProperty in un elenco per agevolare la lettura dei valori e dei dati del Registro di sistema e facilitare l'interpretazione dei risultati.
Nel primo comando viene utilizzato il cmdlet Get-ItemProperty per ottenere le voci del Registro di sistema nella sottochiave Microsoft.PowerShell. In questa sottochiave sono archiviate opzioni per la shell predefinita per Windows PowerShell. I risultati vengono illustrati nell'esempio di output 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ù agevole la visualizzazione in un elenco.
Nel secondo comando viene utilizzato lo stesso comando Get-ItemProperty. Questa volta, tuttavia, nel comando viene utilizzato un operatore pipeline (|) per inviare i risultati del comando al cmdlet Format-List. Nel comando Format-List è utilizzato il parametro Property con un valore di * (tutti) per visualizzare tutte le proprietà degli oggetti processo in un elenco. I risultati vengono illustrati nell'esempio di output seguente.
La visualizzazione risultante mostra le voci del Registro di sistema Path e ExecutionPolicy, insieme a diverse proprietà meno comuni dell'oggetto chiave del Registro di sistema. Le altre proprietà, con prefisso "PS", sono proprietà di oggetti personalizzati di Windows PowerShell, ad esempio oggetti che rappresentano le chiavi del Registro di sistema.
Vedere anche