New-Item

Syntax

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>]

New-Item
   [-Path] <string[]>
   -ConnectionURI <uri>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-Port <int>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-ApplicationName <string>]
   [-Port <int>]
   [-UseSSL]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

Beschreibung

Das New-Item Cmdlet 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. Im Dateisystem New-Item werden z. B. Dateien und Ordner erstellt. Erstellt in der Registrierung New-Item Registrierungsschlüssel und Einträge.

New-Item kann auch den Wert der von ihr erstellten Elemente festlegen. Wenn sie beispielsweise eine neue Datei erstellt, New-Item können Sie der Datei anfänglichen Inhalt hinzufügen.

Beispiele

Beispiel 1: Erstellen einer Datei im aktuellen Verzeichnis

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

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

Beispiel 2: Erstellen eines Verzeichnisses

Mit diesem Befehl wird ein Verzeichnis namens "Logfiles" auf dem C: Laufwerk erstellt. Der ItemType-Parameter 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"

Beispiel 3: Erstellen eines Profils

Mit diesem Befehl wird ein PowerShell-Profil im Pfad erstellt, der von der $profile Variablen 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. Der 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

Beispiel 4: Erstellen eines Verzeichnisses in einem anderen Verzeichnis

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

Der Name des neuen Verzeichniselements "Scripts" ist im Wert des Path-Parameters enthalten, anstatt im Wert des Namens angegeben zu werden. Gemäß Syntax kann der Befehl auf beide Weisen angegeben werden.

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

Beispiel 5: Erstellen mehrerer Dateien

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"

Beispiel 6: Verwenden von Wildcards zum Erstellen von Dateien in mehreren Verzeichnissen

Das New-Item Cmdlet unterstützt Wildcards im Path-Parameter . Mit dem folgenden Befehl wird eine temp.txt Datei in allen Verzeichnissen erstellt, die von den Wildcards im Path-Parameter 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 Get-ChildItem Cmdlet zeigt drei Verzeichnisse unter dem C:\Temp Verzeichnis an. Mithilfe von Wildcards erstellt das New-Item Cmdlet eine temp.txt Datei in allen Verzeichnissen unter dem aktuellen Verzeichnis. Das New-Item Cmdlet gibt die von Ihnen erstellten Elemente aus, die weitergeleitet werden, um die Pfade der neu erstellten Dateien zu Select-Object überprüfen.

Beispiel 7: Erstellen einer symbolischen Verknüpfung zu einer Datei oder einem Ordner

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 Value-Parameter . 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 zu einem Ordner unter Windows einen symbolischen Link erstellen.

Beispiel 8: Verwenden des Parameters "-Force", um zu versuchen, Ordner neu zu erstellen

In diesem Beispiel wird ein Ordner mit einer Datei erstellt. Versuchen Sie dann, denselben Ordner mithilfe von -Force. 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

Beispiel 9: Verwenden des Parameters "-Force", um vorhandene Dateien zu überschreiben

In diesem Beispiel wird eine Datei mit einem Wert erstellt und anschließend die Datei mithilfe -Forcevon . Dadurch wird die vorhandene Datei überschrieben, wie Sie die Längeneigenschaft sehen 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

Parameter

-ApplicationName

-Authentication

-CertificateThumbprint

-Confirm

-ConnectionURI

-Credential

-Force

-ItemType

-Name

-Options

-OptionSet

-Path

-Port

-SessionOption

-UseSSL

-Value

-WhatIf

Eingaben

Object

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

Ausgaben

DictionaryEntry

Das Cmdlet gibt ein DictionaryEntry-Objekt zurück, wenn eine neue Umgebungsvariable erstellt wird.

DirectoryInfo

Das Cmdlet gibt ein DirectoryInfo-Objekt zurück, wenn ein neues Verzeichnis im Dateisystem erstellt wird.

FileInfo

Das Cmdlet gibt ein FileInfo-Objekt zurück, wenn eine neue Datei im Dateisystem erstellt wird.

AliasInfo

Das Cmdlet gibt ein AliasInfo-Objekt zurück, wenn ein neuer Alias erstellt wird.

FunctionInfo

Das Cmdlet gibt ein FunctionInfo-Objekt zurück, wenn eine neue Funktion erstellt wird.

PSVariable

Das Cmdlet gibt ein PSVariable-Objekt zurück, wenn eine neue Variable erstellt wird.

Hinweise

PowerShell enthält die folgenden Aliase für New-Item:

• Alle Plattformen:
  • ni

New-Item ist für die Arbeit mit den Daten konzipiert, die von jedem Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PsProvider. Weitere Informationen finden Sie unter about_Providers.

Ähnliche Themen

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers