Aggiunge contenuto agli elementi specificati, ad esempio aggiunge parole a un file.
Sintassi
Add-Content [-LiteralPath] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Add-Content [-Path] <string[]> [-Value] <Object[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Add-Content aggiunge contenuto a un elemento o a un file specificato. È possibile specificare il contenuto digitandolo nel comando o specificando un oggetto che lo contiene.
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
Esegue l'override dell'attributo di sola lettura, consentendo di aggiungere contenuto a un file di sola lettura.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Include <string[]>
Aggiunge 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 degli elementi che ricevono il contenuto aggiuntivo. 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 |
-PassThru
Restituisce un oggetto che rappresenta il contenuto aggiunto. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string[]>
Specifica il percorso degli elementi che ricevono il contenuto aggiuntivo. È consentito l'utilizzo di caratteri jolly. Se vengono specificati più percorsi, separarli tramite virgole.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Value <Object[]>
Specifica il contenuto da aggiungere. Digitare una stringa racchiusa tra virgolette, ad esempio "Dati riservati esclusivamente all'utilizzo interno", oppure specificare un oggetto con contenuto, ad esempio l'oggetto DateTime generato da Get-Date.
Non è possibile specificare il contenuto di un file digitandone il percorso, perché il percorso è costituito da una stringa. È tuttavia possibile utilizzare un comando Get-Content per ottenere il contenuto e passarlo al parametro Value.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
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.Object È possibile reindirizzare gli oggetti da aggiungere (Value) ad Add-Content. |
|
Output |
Nessuno o System.String Quando si utilizza il parametro Passthru, con Add-Content viene generato un oggetto System.String che rappresenta il contenuto. Negli altri casi, il cmdlet non genera alcun output. |
Note
Quando si reindirizza un oggetto a Add-Content, l'oggetto viene convertito in una stringa prima di essere aggiunto all'elemento. Il tipo di oggetto determina il formato della stringa, ma il formato potrebbe essere diverso dalla visualizzazione predefinita dell'oggetto. Per controllare il formato della stringa, utilizzare i parametri di formattazione del cmdlet di invio.
È inoltre possibile fare riferimento ad Add-Content tramite il relativo alias predefinito "ac". Per ulteriori informazioni, vedere about_Aliases.
Il cmdlet Add-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>add-content -path *.txt -exclude help* -value "END" Descrizione ----------- Con questo comando viene aggiunta la parola "END" a tutti i file di testo nella directory corrente, a eccezione dei file il cui nome inizia con "help".
Esempio 2
C:\PS>add-content -Path file1.log, file2.log -Value (get-date) -passthru Descrizione ----------- Con questo comando la data viene aggiunta alla fine dei file File1.log e File2.log e quindi viene visualizzata nella riga di comando. Viene utilizzato il cmdlet Get-Date per ottenere la data e il parametro Value per passarla ad Add-Content. Il parametro PassThru passa un oggetto che rappresenta il contenuto aggiunto attraverso la pipeline. L'oggetto passato viene visualizzato nella riga di comando non essendo presenti altri cmdlet a riceverlo.
Esempio 3
C:\PS>add-content -path monthly.txt -value (get-content c:\rec1\weekly.txt) Descrizione ----------- Con questo comando il contenuto del file Weekly.txt viene aggiunto alla fine del file Monthly.txt. Viene utilizzato il cmdlet Get-Content per ottenere il contenuto del file Weekly.txt e il parametro Value per passare tale contenuto ad Add-Content. Le parentesi assicurano che il comando Get-Content venga completato prima dell'inizio del comando Add-Content. È inoltre possibile copiare il contenuto del file Weekly.txt in una variabile, ad esempio $w, quindi utilizzare il parametro Value per passare la variabile ad Add-Content. In tal caso, la sintassi del comando sarebbe "add-content -path monthly.txt -value $w".
Esempio 4
C:\PS>add-content -value (get-content test.log) -path C:\tests\test134\logs\test134.log Descrizione ----------- Con questo comando viene creata una nuova directory e un file e viene copiato il contenuto di un file esistente nel file appena creato. In questo comando viene utilizzato il cmdlet Add-Content per aggiungere il contenuto. Il valore del parametro Value è un comando Get-Content che ottiene contenuto da un file esistente, Test.log. Il valore del parametro Path è un percorso che non esiste quando il comando è in esecuzione. In questo esempio, solo le directory C:\Tests esistono. Con il comando vengono create le directory restanti e il file Test134.log. Il parametro Force non è richiesto per questo comando. Con Add-Content vengono create le directory per completare un percorso anche senza il parametro Force.
Vedere anche