mkdir

Modul: Microsoft.PowerShell.Core
Erzeugt ein neues Element.

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

-Name

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

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

-Confirm

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

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

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

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

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

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

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.