Erstellt ein neues Element. (New-Item)
NAMENew-ItemÜBERSICHTErstellt ein neues Element.SYNTAXNew-Item [-Path] <string[]> [-Credential <PSCredential>] [-Force] [-ItemType <string>] [-Value <Object>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] New-Item -Name <string> [[-Path] <string[]>] [-Credential <PSCredential>] [-Force] [-ItemType <string>] [-Value <Object>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]BESCHREIBUNGDas Cmdlet "New-Item" erstellt ein neues Element und legt seinen Wert fest. Die Elementtypen, die erstellt werden können, sind abhängig vom Speicherort des Elements. Im Dateisystem werden mit New-Item z. B. Dateien und Ordner erstellt. In der Registrierung erstellt New-Item Registrierungsschlüssel und -einträge. Mit New-Item kann auch der Wert der erstellten Elemente festgelegt werden. Beim Erstellen einer neuen Datei kann mit New-Item z. B. der erste Inhalt der Datei hinzugefügt werden.PARAMETER-Credential <PSCredential> Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert 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 vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert. Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Force [<SwitchParameter>] Ermöglicht dem Cmdlet das Erstellen eines Elements, durch das ein vorhandenes schreibgeschütztes Element überschrieben wird. Die Implementierung unterscheidet sich bei den einzelnen Anbietern. Weitere Informationen finden Sie unter "about_Providers". Auch bei Verwendung des Force-Parameters kann das Cmdlet keine Sicherheitseinschränkungen außer Kraft setzen. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -ItemType <string> Gibt den vom Anbieter angegebenen Typ des neuen Elements an. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Name <string> Gibt den Namen des neuen Elements an. Mit diesem Parameter können Sie den Namen des neuen Elements angeben oder in den Wert des Path-Parameters einschließen. Erforderlich? true Position? named Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Path <string[]> Gibt den Pfad zum Speicherort des neuen Elements an. Platzhalter sind zulässig. Sie können den Namen des neuen Elements im Name-Parameter angeben oder in den Path-Parameter einschließen. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Value <Object> Gibt den Wert des neuen Elements an. Sie können einen Wert auch über die Pipeline an New-Item übergeben. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?true (ByValue, ByPropertyName) Platzhalterzeichen akzeptieren?false -Confirm [<SwitchParameter>] Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -WhatIf [<SwitchParameter>] Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -UseTransaction [<SwitchParameter>] Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions". Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false <CommonParameters> Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENSystem.Object Sie können einen Wert für das neue Element über die Pipeline an das Cmdlet "New-Item" übergeben.AUSGABENSystem.Object New-Item gibt das selbst erstellte Element zurück.HINWEISEDas Cmdlet "New-Item" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PsProvider" ein. Weitere Informationen finden Sie unter "about_Providers".Beispiele
BEISPIEL 1C:\PS>new-item -path . -name testfile1.txt -type "file" -value "This is a text string." Beschreibung ----------- 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 Text in Anführungszeichen, der auf den Value-Parameter folgt, wird der Datei als Inhalt hinzugefügt.BEISPIEL 2C:\PS>new-item -path c:\ -name logfiles -type directory Beschreibung ----------- Mit diesem Befehl wird ein Verzeichnis mit dem Namen "logfiles" auf Laufwerk "C:" erstellt. Der Type-Parameter gibt an, dass das neue Element ein Verzeichnis und keine Datei oder ein sonstiges Element des Dateisystems ist.BEISPIEL 3C:\PS>new-item -path $profile -type file -force Beschreibung ----------- Mit diesem Befehl wird ein Windows PowerShell-Profil unter dem Pfad erstellt, der durch die Variable "$profile" angegeben wird. Mit Profilen können Sie Windows PowerShell anpassen. "$Profile" ist eine automatische (integrierte) Variable, in der der Pfad und der Dateiname des Windows Profils "CurrentUser/CurrentHost" gespeichert werden. Standardmäßig ist das Profil nicht vorhanden, selbst wenn in Windows PowerShell ein entsprechender Pfad und Dateiname gespeichert sind. In diesem Befehl stellt die Variable "$profile" den Pfad zur Datei dar. Mit dem Type-Parameter (bzw. "InfoType") wird angegeben, dass durch den Befehl eine Datei erstellt wird. Mit dem Force-Parameter können Sie eine Datei im Profilpfad erstellen, selbst wenn die Verzeichnisse im Pfad nicht vorhanden sind (diese werden von Windows PowerShell erstellt). Nachdem mit diesem Befehl ein Profil erstellt wurde, können Sie Aliase, Funktionen und Skripts im Profil eingeben, um die Shell anzupassen. Weitere Informationen finden Sie unter "about_Automatic_Variables" und "about_Profiles".BEISPIEL 4C:\PS>new-item -type directory -path c:\ps-test\scripts Beschreibung ----------- Mit diesem Befehl wird ein neues Verzeichnis "Scripts" im Verzeichnis "C:\PS-Test" erstellt. Der Name des neuen Verzeichniselements "Scripts" wird in den Wert des Path-Parameters aufgenommen und nicht im Wert des Name-Parameters angegeben. Gemäß Syntax kann der Befehl auf beide Weisen angegeben werden. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113353 (möglicherweise auf Englisch) about_Providers Get-Item Set-Item Remove-Item Clear-Item Invoke-Item Rename-Item Move-Item Copy-Item C:\Windows>powershell get-help Set-Item -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
