Syntax
mkdir <String>
mkdir <String>] -Name <String>
Beschreibung
Das Cmdlet „New-Item“ erstellt ein neues Element und legt seinen Wert fest.Die Arten von Elementen, die erstellt werden können, hängen vom Speicherort des Elements ab.Im Dateisystem wird New-Item beispielsweise zum Erstellen von Dateien und Ordnern verwendet.In der Registrierung erstellt New-Item Registrierungsschlüssel und -einträge.
New-Item kann auch den Wert der von ihm erstellten Elemente festlegen, z. B. kann New-Item beim Erstellen einer neuen Datei den ursprünglichen Inhalt der Datei hinzufügen.
Beispiele
————————– BEISPIEL 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Dieser Befehl erstellt eine Textdatei mit dem Namen testfile1.txt im aktuellen Verzeichnis.Der Punkt (.) im Wert des Path-Parameters gibt das aktuelle Verzeichnis an.Der in Anführungszeichen gesetzte Text, der auf den Value-Parameter folgt, wird der Datei als Inhalt hinzugefügt.
————————– BEISPIEL 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
Mit diesem Befehl wird ein Verzeichnis mit dem Namen „Logfiles“ im Laufwerk C: erstellt.Der Parameter ItemType gibt an, dass es sich bei dem neuen Element um ein Verzeichnis und nicht um eine Datei oder ein anderes Dateisystemobjekt handelt.
————————– BEISPIEL 3 ————————–
PS C:\>new-item -path $profile -itemtype file -force
Mit diesem Befehl wird ein Windows PowerShell-Profil in dem Pfad erstellt, der durch die Variable „$profile“ angegeben ist.
Sie können Profile verwenden, um Windows PowerShell anzupassen.$Profile ist eine automatische (eingebaute) Variable, die den Pfad und den Dateinamen des CurrentUser/CurrentHost-Profils speichert. Standardmäßig ist das Profil nicht vorhanden, obwohl Windows PowerShell einen Pfad und einen Dateinamen dafür speichert.
In diesem Befehl stellt die Variable „$profile“ den Pfad zur Datei dar.Der ItemType-Parameter gibt an, dass der Befehl eine Datei erstellt.Der Force-Parameter ermöglicht es Ihnen, eine Datei im Profilpfad zu erstellen, selbst wenn die Verzeichnisse im Pfad nicht vorhanden sind (Windows PowerShell erstellt sie).
Nachdem Sie mit diesem Befehl 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.
————————– BEISPIEL 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Dieser Befehl erstellt ein neues Verzeichnis Scripts im Verzeichnis C:\PS-Test.
Der Name des neuen Verzeichniselements, Scripts, ist im Wert des Path-Parameters enthalten, anstatt im Wert des Name-Parameters angegeben zu werden.
————————– BEISPIEL 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
In diesem Befehl werden mit dem Cmdlet „New-Item“ Dateien in zwei verschiedenen Verzeichnissen erstellt.Da der Path-Parameter mehrere Zeichenfolgen aufnehmen kann, können Sie damit mehrere Elemente erstellen.
Erforderliche Parameter
Gibt den Namen des neuen Elements an.
Sie können den Namen des neuen Elements im Name- oder Path-Parameterwert angeben, und Sie können den Pfad zum neuen Element im Name- oder Path-Parameterwert angeben.
Typ: | Zeichenfolge |
Position: | Benannt |
Standardwert: | Keine |
Eingabe in die Pipeline akzeptieren: | True (ByPropertyName) |
Akzeptiert Platzhalterzeichen: | False |
Gibt den Pfad zum Speicherort des neuen Elements an, wobei Platzhalter zulässig sind.
Sie können den Namen des neuen Elements im Name-Parameter angeben oder ihn in den Path-Parameter aufnehmen.
Typ: | String |
Position: | 1 |
Standardwert: | Keine |
Eingabe in die Pipeline akzeptieren: | True (ByPropertyName) |
Akzeptiert Platzhalterzeichen: | False |
Optionale Parameter
Fordert Sie vor der Ausführung des Cmdlets zur Bestätigung auf.Fordert Sie vor der Ausführung des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Benannt |
Standardwert: | Falsch |
Eingabe in die Pipeline akzeptieren: | Falsch |
Platzhalterzeichen akzeptieren: | False |
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt; der Standard 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 mit dem Cmdlet „Get-Credential“ generiertes Objekt.Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter wird von keinem mit Windows PowerShell installierten Anbieter unterstützt
Typ: | PSCredential |
Position: | Benannt |
Standardwert: | Keine |
Eingabe in die Pipeline akzeptieren: | True (ByPropertyName) |
Akzeptiert Platzhalterzeichen: | False |
Ermöglicht es dem Cmdlet, ein Element zu erstellen, das ein vorhandenes schreibgeschütztes Element überschreibt.Die Implementierung variiert von Anbieter zu Anbieter.Weitere Informationen finden Sie unter about_Providers.Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen.
Typ: | SwitchParameter |
Position: | Benannt |
Standardwert: | Keine |
Eingabe in die Pipeline akzeptieren: | Falsch |
Akzeptiert Platzhalterzeichen: | False |
Nimmt den Befehl in die aktive Transaktion auf.Dieser Parameter ist nur gültig, wenn eine Transaktion im Gange ist.Weitere Informationen finden Sie unter Nimmt den Befehl in die aktive Transaktion auf.Dieser Parameter ist nur gültig, wenn eine Transaktion im Gange ist.Weitere Informationen finden Sie unter
Typ: | SwitchParameter |
Aliase: | usetx |
Position: | Benannt |
Standardwert: | Falsch |
Eingabe in die Pipeline akzeptieren: | Falsch |
Platzhalterzeichen akzeptieren: | False |
Gibt den Wert des neuen Elements an, Sie können auch einen Wert über die Pipeline an New-Item übergeben.
Typ: | Objekt |
Position: | Benannt |
Standardwert: | Keine |
Eingabe in die Pipeline akzeptieren: | Wahr (ByPropertyName, ByValue) |
Akzeptiere Platzhalterzeichen: | False |
Zeigt an, was passieren würde, wenn das Cmdlet ausgeführt wird.Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliase: | wi |
Position: | Benannt |
Standardwert: | Falsch |
Eingabe in die Pipeline akzeptieren: | Falsch |
Platzhalterzeichen akzeptieren: | False |
Inputs
System.Object
Sie können über die Pipeline einen Wert für das neue Element an das Cmdlet „New-Item“ übergeben.
Outputs
System.Object
New-Item gibt das erstellte Element zurück.
Hinweise
Das Cmdlet „New-Item“ ist so konzipiert, dass es mit den von einem beliebigen Anbieter bereitgestellten Daten arbeiten kann.Um die in Ihrer Sitzung verfügbaren Anbieter aufzulisten, geben Sie „Get-PsProvider“ ein.Weitere Informationen finden Sie unter about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers