Freigeben über

New-Item

  • Referenz
Modul:
Microsoft.PowerShell.Management

Erstellt ein neues Element.

Syntax

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

Beschreibung

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

New-Item kann auch den Wert der erstellten Elemente festlegen. Wenn sie z. B. eine neue Datei erstellt, New-Item können Sie der Datei anfängliche Inhalte hinzufügen.

Beispiele

Beispiel 1: Create 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 Anführungszeichentext, der dem Parameter Value folgt, wird der Datei als Inhalt hinzugefügt.

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

Beispiel 2: Create eines Verzeichnisses

Mit diesem Befehl wird ein Verzeichnis mit dem Namen "Logfiles" auf dem C: Laufwerk erstellt. Der ItemType-Parameter gibt an, dass das neue Element ein Verzeichnis, kein Datei- oder ein anderes Dateisystemobjekt ist.

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

Beispiel 3: Create eines Profils

Mit diesem Befehl wird ein PowerShell-Profil in dem 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 einen 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 Force-Parameter 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

Hinweis

Wenn Sie eine Datei mit dieser Methode erstellen, wird die resultierende Datei als UTF-8 ohne byte-order-mark (BOM) codiert.

Beispiel 4: Create eines Verzeichnisses in einem anderen Verzeichnis

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

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

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

Beispiel 5: Create mehrerer Dateien

In diesem Beispiel werden Dateien in zwei verschiedenen Verzeichnissen erstellt. Da Pfad mehrere Zeichenfolgen benötigt, können Sie ihn verwenden, um mehrere Elemente zu erstellen.

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Hinweis

Dieser Parameter wird von keinem Anbieter unterstützt, der mit PowerShell installiert ist. Verwenden Invoke-CommandSie , um die Identität eines anderen Benutzers zu annehmen oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Erzwingt dieses Cmdlet, ein Element zu erstellen, das über ein vorhandenes schreibgeschütztes Element schreibt. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter about_Providers. Selbst mit dem Force-Parameter kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ItemType

Gibt den vom Anbieter angegebenen Typ des neuen Elements an. Die verfügbaren Werte dieses Parameters hängen vom aktuellen Anbieter ab, den Sie verwenden.

Wenn sich Ihr Standort auf einem FileSystem Laufwerk befindet, sind die folgenden Werte zulässig:

  • Datei
  • Verzeichnis
  • SymbolicLink
  • Verbindung
  • HardLink

Wenn Sie eine Datei mit dieser Methode erstellen, wird die resultierende Datei als UTF-8 ohne byte-order-mark (BOM) codiert.

In einem Certificate Laufwerk können Sie die folgenden Werte angeben:

  • Zertifikat-Anbieter
  • Zertifikat
  • Speicher
  • StoreLocation

Weitere Informationen finden Sie unter about_Providers.

Type:String
Aliases:Type
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen des neuen Elements an.

Sie können den Namen des neuen Elements im Parameterwert Name oder Path angeben, und Sie können den Pfad des neuen Elements in Name oder Path-Wert angeben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Gibt den Pfad des Speicherorts des neuen Elements an. Platzhalterzeichen sind zulässig.

Sie können den Namen des neuen Elements in Name angeben oder in Pfad einschließen.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Gibt den Wert des neuen Elements an. Sie können auch einen Wert an übergeben New-Item.

Type:Object
Aliases:Target
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Object

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

Ausgaben

Object

Dieses Cmdlet gibt das element zurück, das erstellt wird.

Hinweise

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