Add-Content
Fügt den angegebenen Elementen Inhalt hinzu, z. B. hinzufügen von Wörtern zu einer Datei.
Syntax
Path (Standard)
Add-Content
[-Path] <string[]>
[-Value] <Object[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]
LiteralPath
Add-Content
[-Value] <Object[]>
-LiteralPath <string[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Add-Content fügt Inhalt an ein angegebenes Element oder eine angegebene Datei an. Sie können den Inhalt angeben, indem Sie den Inhalt in den Befehl eingeben oder indem Sie ein Objekt angeben, das den Inhalt enthält.
Wenn Sie Dateien oder Verzeichnisse für die folgenden Beispiele erstellen müssen, lesen Sie New-Item.
Beispiele
Beispiel 1: Hinzufügen einer Zeichenfolge zu allen Textdateien mit Ausnahme
In diesem Beispiel wird ein Wert an Textdateien im aktuellen Verzeichnis angefügt, jedoch dateien basierend auf ihrem Dateinamen ausgeschlossen.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Das Add-Content Cmdlet verwendet den Parameter Path , um alle .txt Dateien im aktuellen Verzeichnis anzugeben. Der Parameter Exclude ignoriert Dateinamen, die dem angegebenen Muster entsprechen. Der parameter Value gibt die Textzeichenfolge an, die in die Dateien geschrieben wird.
Verwenden Sie Get-Content-, um den Inhalt dieser Dateien anzuzeigen.
Beispiel 2: Hinzufügen eines Datums zum Ende der angegebenen Dateien
In diesem Beispiel wird das Datum an Dateien im aktuellen Verzeichnis angefügt und das Datum in der PowerShell-Konsole angezeigt.
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log
Das Add-Content Cmdlet verwendet die Parameter Path und Value , um zwei neue Dateien im aktuellen Verzeichnis zu erstellen. Der Parameter Value gibt das Get-Date Cmdlet zum Abrufen des Datums an und übergibt das Datum an Add-Content. Das Add-Content Cmdlet schreibt das Datum in jede Datei. Der PassThru-Parameter übergibt ein Objekt, das das Datumsobjekt darstellt. Da es kein anderes Cmdlet zum Empfangen des übergebenen Objekts gibt, wird es in der PowerShell-Konsole angezeigt. Das Get-Content Cmdlet zeigt die aktualisierte Datei DateTimeFile1.log.
Beispiel 3: Hinzufügen des Inhalts einer angegebenen Datei zu einer anderen Datei
In diesem Beispiel wird der Inhalt aus einer Datei abgerufen und an eine andere Datei angefügt.
Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt
Das Add-Content Cmdlet verwendet den Parameter Path , um die neue Datei im aktuellen Verzeichnis anzugeben, CopyToFile.txt. Der Parameter Value verwendet das Get-Content Cmdlet, um den Inhalt der Datei abzurufen, CopyFromFile.txt. Die Klammern um das cmdlet Get-Content stellen sicher, dass der Befehl abgeschlossen ist, bevor der Befehl Add-Content beginnt. Der Parameter Value wird an Add-Contentübergeben. Das Add-Content Cmdlet fügt die Daten an die CopyToFile.txt Datei an. Das Get-Content Cmdlet zeigt die aktualisierte Datei CopyToFile.txt.
Beispiel 4: Verwenden einer Variablen zum Hinzufügen des Inhalts einer angegebenen Datei zu einer anderen Datei
In diesem Beispiel wird der Inhalt aus einer Datei abgerufen und der Inhalt in einer Variablen gespeichert. Die Variable wird verwendet, um den Inhalt an eine andere Datei anzufügen.
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
Das Get-Content Cmdlet ruft den Inhalt von CopyFromFile.txt ab und speichert den Inhalt in der $From Variablen. Das Add-Content Cmdlet verwendet den Parameter Path , um die CopyToFile.txt Datei im aktuellen Verzeichnis anzugeben. Der Parameter Value verwendet die $From Variable und übergibt den Inhalt an Add-Content. Das Add-Content Cmdlet aktualisiert die CopyToFile.txt Datei. Das Cmdlet Get-Content zeigt CopyToFile.txtan.
Beispiel 5: Erstellen einer neuen Datei und Kopieren von Inhalten
In diesem Beispiel wird eine neue Datei erstellt und der Inhalt einer vorhandenen Datei in die neue Datei kopiert.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
Das cmdlet Add-Content verwendet die Parameter Path und Value Parameter, um eine neue Datei im aktuellen Verzeichnis zu erstellen. Der Parameter Value verwendet das Get-Content Cmdlet, um den Inhalt einer vorhandenen Datei abzurufen, CopyFromFile.txt. Die Klammern um das cmdlet Get-Content stellen sicher, dass der Befehl abgeschlossen ist, bevor der Befehl Add-Content beginnt. Der Parameter Value übergibt den Inhalt, mit dem Add-Content die NewFile.txt Datei aktualisiert wird. Das Get-Content Cmdlet zeigt den Inhalt der neuen Datei NewFile.txt.
Beispiel 6: Hinzufügen von Inhalten zu einer schreibgeschützten Datei
Mit diesem Befehl wird der Wert der Datei auch dann hinzugefügt, wenn das Dateiattribut IsReadOnly auf True festgelegt ist. Die Schritte zum Erstellen einer schreibgeschützten Datei sind im Beispiel enthalten.
New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $True
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt
Mode LastWriteTime Length Name
---- ------------- ------ ----
-ar--- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt
Das New-Item Cmdlet verwendet die Parameter Path und ItemType , um die Datei zu erstellen, die sich im aktuellen Verzeichnis IsReadOnlyTextFile.txt. Das cmdlet Set-ItemProperty verwendet die Parameter Name und Value, um die IsReadOnly- Eigenschaft der Datei in "True" zu ändern. Das Get-ChildItem Cmdlet zeigt an, dass die Datei leer ist (0) und das schreibgeschützte Attribut (r) aufweist. Das cmdlet Add-Content verwendet den parameter Path, um die Datei anzugeben. Der parameter Value enthält die Textzeichenfolge, die an die Datei angefügt werden soll. Der Parameter Force schreibt den Text in die schreibgeschützte Datei. Das cmdlet Get-Content verwendet den parameter Path, um den Inhalt der Datei anzuzeigen.
Um das Attribut read-only zu entfernen, verwenden Sie den Set-ItemProperty Befehl mit dem Parameter Value, der auf False festgelegt ist.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Warnung
Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Encoding
Gibt den Typ der Codierung für die Zieldatei an. Der Standardwert ist Default.
Die zulässigen Werte für diesen Parameter sind wie folgt:
- ASCII Verwendet den ASCII-Zeichensatz (7-Bit).
- BigEndianUnicode Verwendet UTF-16 mit der Big-Endian-Bytereihenfolge.
- BigEndianUTF32 Verwendet UTF-32 mit der Big-Endian-Bytereihenfolge.
- Byte Codiert einen Satz von Zeichen in eine Sequenz von Bytes.
- Vorgabe Verwendet die Codierung, die der aktiven Codepage des Systems entspricht (in der Regel ANSI).
- OEM Verwendet die Codierung, die der aktuellen OEM-Codepage des Systems entspricht.
- Schnur Identisch mit Unicode.
- Unicode Verwendet UTF-16 mit der Little-Endian-Byte-Reihenfolge.
- Unbekannt Identisch mit Unicode.
- UTF7 (Englisch ) Verwendet UTF-7.
- UTF8-Datei Verwendet UTF-8.
- UTF32 Verwendet UTF-32 mit der Little-Endian-Byte-Reihenfolge.
Die Codierung ist ein dynamischer Parameter, den der FileSystem-Anbieter dem Cmdlet Add-Content hinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken.
Parametereigenschaften
| Typ: | FileSystemCmdletProviderEncoding |
| Standardwert: | Default |
| Zulässige Werte: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Exclude
Lässt die angegebenen Elemente aus. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder -muster ein, z. B. *.txt. Wildcards sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Wert dieses Parameters qualifiziert den parameter Path. Die Syntax des Filters, einschließlich der Verwendung von Wildcards, hängt vom Anbieter ab. Filter sind effizienter als andere Parameter, da der Anbieter Filter anwendet, wenn Objekte abgerufen werden. Andernfalls verarbeitet PowerShell Filter nach dem Abrufen der Objekte.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Überschreibt das Schreibschutzattribut, sodass Sie einer schreibgeschützten Datei Inhalt hinzufügen können. Beispielsweise überschreibt Force das Schreibschutzattribut oder erstellt Verzeichnisse zum Vervollständigen eines Dateipfads. Es wird jedoch nicht versucht, Dateiberechtigungen zu ändern.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Include
Fügt nur die angegebenen Elemente hinzu. Der Wert dieses Parameters qualifiziert den parameter Path. Geben Sie ein Pfadelement oder -muster ein, z. B. *.txt. Wildcards sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LiteralPath
Gibt den Pfad zu den Elementen an, die den zusätzlichen Inhalt erhalten. Im Gegensatz zu Path wird der Wert von LiteralPath genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | PSPath |
Parametersätze
LiteralPath
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-NoNewline
Gibt an, dass dieses Cmdlet dem Inhalt keine neue Zeile oder keinen Wagenrücklauf hinzufügt.
Die Zeichenfolgendarstellungen der Eingabeobjekte werden verkettet, um die Ausgabe zu bilden. Zwischen den Ausgabezeichenfolgen werden keine Leerzeichen oder Newlines eingefügt. Nach der letzten Zeichenfolge der Ausgabe wird kein Zeilenumbruch eingefügt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PassThru
Gibt ein Objekt zurück, das den hinzugefügten Inhalt darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt den Pfad zu den Elementen an, die den zusätzlichen Inhalt erhalten. Wildcards sind zulässig. Wenn Sie mehrere Pfade angeben, verwenden Sie Kommas, um die Pfade zu trennen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
Path
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Stream
Gibt einen alternativen Datenstrom für Inhalt an. Wenn der Datenstrom nicht vorhanden ist, erstellt es dieses Cmdlet. Platzhalterzeichen werden nicht unterstützt.
Stream ist ein dynamischer Parameter, den der FileSystem-Anbieter zu Add-Contenthinzufügt. Dieser Parameter funktioniert nur auf Dateisystemlaufwerken.
Sie können das Add-Content Cmdlet verwenden, um den Inhalt des alternativen Datenstroms Zone.Identifier zu ändern. Dies wird jedoch nicht als Möglichkeit empfohlen, Sicherheitsprüfungen zu beseitigen, die Dateien blockieren, die aus dem Internet heruntergeladen werden. Wenn Sie überprüfen, ob eine heruntergeladene Datei sicher ist, verwenden Sie das Cmdlet Unblock-File.
Dieser Parameter wurde in PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UseTransaction
Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | usetx |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Value
Gibt den hinzuzufügenden Inhalt an. Geben Sie eine zitierte Zeichenfolge ein, z. B. Diese Daten sind nur für den internen Gebrauch bestimmt, oder geben Sie ein Objekt an, das Inhalt enthält, z. B. das DateTime--Objekt, das generiert wird Get-Date.
Sie können den Inhalt einer Datei nicht angeben, indem Sie den Pfad eingeben, da es sich bei dem Pfad nur um eine Zeichenfolge handelt.
Sie können einen Get-Content-Befehl verwenden, um den Inhalt abzurufen und an den parameter Value zu übergeben.
Parametereigenschaften
| Typ: | Object[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
System.Object, System.Management.Automation.PSCredential
Sie können Werte, Pfade oder Anmeldeinformationen über die Pipeline an Set-Content.
Ausgaben
None or System.String
Wenn Sie den PassThru-Parameter verwenden, wird ein Add-Content generiert, das den Inhalt darstellt. Andernfalls generiert dieses Cmdlet keine Ausgabe.
Hinweise
Wenn Sie die Pipeline für ein Objekt an Add-Contentübergeben, wird das Objekt in eine Zeichenfolge konvertiert, bevor es dem Element hinzugefügt wird. Der Objekttyp bestimmt das Zeichenfolgenformat, aber das Format unterscheidet sich möglicherweise von der Standardanzeige des Objekts. Verwenden Sie zum Steuern des Zeichenfolgenformats die Formatierungsparameter des sendenden Cmdlets.
Sie können sich auch an Add-Content durch seinen eingebauten Alias, ac. Weitere Informationen finden Sie unter about_Aliases.
Das Cmdlet Add-Content ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.