Ottiene il contenuto dell'elemento nella posizione specificata.
Sintassi
Get-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>] Get-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Get-Content ottiene il contenuto dell'elemento nella posizione specificata dal percorso, ad esempio il testo di un file. Il contenuto viene letto una riga alla volta e viene restituito un oggetto per ogni riga.
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.
|
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
Ignora le restrizioni che impediscono la corretta esecuzione del comando, purché le modifiche non abbiano effetti negativi sulla sicurezza. Force, ad esempio, ignora l'attributo di sola lettura o crea directory per completare un percorso di file, ma non tenta di modificare le autorizzazioni per il file.
|
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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-LiteralPath <string[]>
Specifica il percorso di un 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-Content recupera il contenuto dell'elemento. È consentito l'utilizzo di caratteri jolly. Il nome del parametro ("Path" o "FilePath") è facoltativo.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-ReadCount <Int64>
Specifica quante righe di contenuto vengono inviate contemporaneamente attraverso la pipeline. Il valore predefinito è 1. Un valore di 0 (zero) comporta l'invio di tutto il contenuto in una volta.
Questo parametro non modifica il contenuto visualizzato, ma influisce sul tempo necessario per visualizzarlo. Più aumenta il valore di ReadCount, più aumenta il tempo necessario per restituire la prima riga, mentre il tempo totale dell'operazione diminuisce. Questa condizione può costituire una differenza importante per gli elementi di grandi dimensioni.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-TotalCount <Int64>
Specifica quante righe di contenuto vengono recuperate. L'impostazione predefinita è -1 (tutte le righe).
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (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 |
Nessuno Non è possibile reindirizzare l'input a Get-Content. |
|
Output |
Object Get-Content restituisce oggetti che rappresentano il contenuto ottenuto. Il tipo di oggetto dipende dal tipo di contenuto. |
Note
È inoltre possibile fare riferimento a Get-Content tramite i relativi alias predefiniti "cat", "type" e "gc". Per ulteriori informazioni, vedere about_Aliases.
Il cmdlet Get-Content è 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-content -Path C:\Chapters\chapter1.txt Descrizione ----------- Con questo comando il contenuto del file Chapter1.txt viene visualizzato sulla console. Viene utilizzato il parametro Path per specificare il nome dell'elemento. Get-Content passa in realtà il contenuto attraverso la pipeline, ma poiché non sono presenti altri elementi della pipeline, il contenuto viene formattato e visualizzato sulla console.
Esempio 2
C:\PS>get-content c:\Logs\Log060912.txt -totalcount 50 | set-content sample.txt Descrizione ----------- Con questo comando si ottengono le prime 50 righe del file Log060912.txt, le quali vengono successivamente archiviate nel file sample.txt. Viene utilizzato il cmdlet Get-Content per ottenere il testo presente nel file. Il nome del parametro Path facoltativo è omesso. Il parametro TotalCount limita il recupero alle prime 50 righe. Il risultato viene inviato dall'operatore pipeline (|) a Set-Content, tramite il quale viene collocato nel file sample.txt.
Esempio 3
C:\PS>(get-content cmdlets.txt -totalcount 5)[-1] Descrizione ----------- Con questo comando viene ottenuta la quinta riga del file di testo Cmdlets.txt. Viene utilizzato il parametro TotalCount per ottenere le prime cinque righe e quindi viene utilizzata la notazione di matrice per ottenere l'ultima riga (indicata da "-1") dell'insieme risultante.
Vedere anche