New-Item

New-Item
    [-Path] <String[]>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-Item
    [[-Path] <String[]>]
    -Name <String>
    [-ItemType <String>]
    [-Value <Object>]
    [-Force]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Das Cmdlet New-Item erstellt ein neues Element und legt seinen Wert fest. Die Typen von Elementen, die erstellt werden können, hängen vom Speicherort des Elements ab. Beispielsweise erstellt New-Item im Dateisystem Dateien und Ordner. In der Registrierung erstellt New-Item Registrierungsschlüssel und Einträge.

New-Item können auch den Wert der von ihr erstellten Elemente festlegen. Wenn sie beispielsweise eine neue Datei erstellt, kann New-Item der Datei anfänglichen Inhalt hinzufügen.For example, when it creates a new file, New-Item can add initial content to the file.

Mit diesem Befehl wird eine Textdatei mit dem Namen "testfile1.txt" im aktuellen Verzeichnis erstellt. Der Punkt ('.') im Wert des parameters Path gibt das aktuelle Verzeichnis an. Der an zitierte Text, der auf den Value-Parameter folgt, wird der Datei als Inhalt hinzugefügt.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

Mit diesem Befehl wird ein Verzeichnis namens "Logfiles" im C: Laufwerk erstellt. Der parameter ItemType gibt an, dass es sich bei dem neuen Element um ein Verzeichnis handelt, nicht um ein Datei- oder ein anderes Dateisystemobjekt.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

Mit diesem Befehl wird ein PowerShell-Profil im Pfad erstellt, der durch die variable $profile angegeben wird.

Sie können Profile verwenden, um PowerShell anzupassen. $profile ist eine automatische (integrierte) Variable, die den Pfad und Dateinamen des Profils "CurrentUser/CurrentHost" speichert. Standardmäßig ist das Profil nicht vorhanden, obwohl PowerShell einen Pfad und Dateinamen dafür speichert.

In diesem Befehl stellt die $profile Variable den Pfad der Datei dar. ItemType Parameter gibt an, dass der Befehl eine Datei erstellt. Mit dem parameter Force können Sie eine Datei im Profilpfad erstellen, auch wenn die Verzeichnisse im Pfad nicht vorhanden sind.

Nachdem Sie ein Profil erstellt haben, können Sie Aliase, Funktionen und Skripts in das Profil eingeben, um Ihre Shell anzupassen.

Weitere Informationen finden Sie unter about_Automatic_Variables und about_Profiles.

New-Item -Path $profile -ItemType "file" -Force

In diesem Beispiel wird ein neues Skriptverzeichnis im Verzeichnis "C:\PS-Test" erstellt.

Der Name des neuen Verzeichniselements "Scripts" ist im Wert von Path Parameter enthalten, anstatt im Wert von Nameangegeben zu werden. Wie durch die Syntax angegeben, ist eines der Befehlsformulare gültig.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

In diesem Beispiel werden Dateien in zwei verschiedenen Verzeichnissen erstellt. Da Path mehrere Zeichenfolgen akzeptiert, können Sie sie verwenden, um mehrere Elemente zu erstellen.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Das cmdlet New-Item unterstützt Im parameter Path Wildcards. Der folgende Befehl erstellt eine temp.txt Datei in allen Verzeichnissen, die durch die Wildcards im parameter Path angegeben werden.

Get-ChildItem -Path C:\Temp\

    Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

Das Cmdlet Get-ChildItem enthält drei Verzeichnisse unter dem Verzeichnis C:\Temp. Mithilfe von Wildcards erstellt das Cmdlet New-Item eine temp.txt Datei in allen Verzeichnissen unter dem aktuellen Verzeichnis. Das cmdlet New-Item gibt die von Ihnen erstellten Elemente aus, die an Select-Object weitergeleitet werden, um die Pfade der neu erstellten Dateien zu überprüfen.

In diesem Beispiel wird eine symbolische Verknüpfung mit der Notice.txt Datei im aktuellen Ordner erstellt.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

In diesem Beispiel ist Target ein Alias für den parameter Value. Das Ziel der symbolischen Verknüpfung kann ein relativer Pfad sein. Vor PowerShell v6.2 muss das Ziel ein vollqualifizierter Pfad sein.

Ab PowerShell 7.1 können Sie nun mithilfe eines relativen Pfads einen SymbolicLink- zu einem Ordner unter Windows erstellen.

In diesem Beispiel wird ein Ordner mit einer Datei erstellt. Versuchen Sie dann, denselben Ordner mithilfe von -Forcezu erstellen. Der Ordner wird nicht überschrieben, sondern einfach das vorhandene Ordnerobjekt mit der erstellten Datei zurückgegeben.

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

In diesem Beispiel wird eine Datei mit einem Wert erstellt und anschließend mithilfe von -Forceneu erstellt. Dadurch wird die vorhandene Datei überschrieben und sie verliert ihren Inhalt, wie Sie an der length-Eigenschaft erkennen können

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

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.

Sie können einen Wert für das neue Element an dieses Cmdlet weiterleiten.

Dieses Cmdlet gibt das Element zurück, das es erstellt.

New-Item ist für die Arbeit mit den daten konzipiert, die von jedem 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.