Syntax
mkdir <String>
mkdir <String>] -Name <String>
Beschrijving
Het cmdlet New-Item maakt een nieuw item en stelt de waarde ervan in.De soorten items die kunnen worden gemaakt, hangen af van de locatie van het item.In het bestandssysteem wordt New-Item bijvoorbeeld gebruikt om bestanden en mappen te maken.In het register maakt New-Item registersleutels en vermeldingen aan.
New-Item kan ook de waarde instellen van de items die het creëert.Bijvoorbeeld, bij het creëren van een nieuw bestand, kan New-Item initiële inhoud toevoegen aan het bestand.
Voorbeelden
————————– VOORBEELD 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."
Dit commando maakt een tekstbestand aan met de naam testfile1.txt in de huidige directory.De punt (.) in de waarde van de parameter Pad geeft de huidige directory aan.De tekst tussen aanhalingstekens die volgt op de parameter Waarde wordt als inhoud aan het bestand toegevoegd.
————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directory
Deze opdracht maakt een directory met de naam Logfiles op station C. De parameter ItemType geeft aan dat het nieuwe item een directory is en geen bestand of ander bestandssysteemobject.
————————–
PS C:\>new-item -path $profile -itemtype file -force
Met deze opdracht wordt een Windows PowerShell-profiel gemaakt op het pad dat is opgegeven met de variabele $profile.
U kunt profielen gebruiken om Windows PowerShell aan te passen.$Profile is een automatische (ingebouwde) variabele die het pad en de bestandsnaam van het CurrentUser/CurrentHost-profiel opslaat.Standaard bestaat het profiel niet, ook al slaat Windows PowerShell er een pad en bestandsnaam voor op.
In deze opdracht staat de variabele $profile voor het pad naar het bestand.De parameter ItemType geeft aan dat de opdracht een bestand maakt.Met de parameter Force kunt u een bestand maken in het profielpad, zelfs als de mappen in het pad niet bestaan (Windows PowerShell maakt ze aan).
Nadat u dit commando hebt gebruikt om een profiel te maken, kunt u aliassen, functies en scripts in het profiel opnemen om uw shell aan te passen.
Voor meer informatie, zie about_Automatic_Variables en about_Profiles.
————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scripts
Dit commando maakt een nieuwe Scripts directory in de C:\PS-Test directory.
De naam van de nieuwe map, Scripts, is opgenomen in de waarde van de parameter Pad, in plaats van te worden opgegeven in de waarde van de parameter Naam.Zoals aangegeven door de syntaxis, zijn beide commandovormen geldig.
————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"
Deze opdracht maakt gebruik van het cmdlet New-Item om bestanden in twee verschillende directory’s te maken.Omdat de parameter Path meerdere tekenreeksen kan bevatten, kunt u deze gebruiken om meerdere items te maken.
Verplichte parameters
Specificeert de naam van het nieuwe item.
U kunt de naam van het nieuwe item in de parameterwaarde Naam of Pad opgeven, en u kunt het pad naar het nieuwe item in de parameterwaarde Naam of Pad opgeven.
Type: | String |
Positie: | Genoemd |
Standaardwaarde: | Geen |
Accepteer invoer pijplijn: | True (ByPropertyName) |
Accepteer wildcard tekens: | False |
Specificeert het pad naar de locatie van het nieuwe item.Wildcards zijn toegestaan.
U kunt de naam van het nieuwe item opgeven in de parameter Name, of deze opnemen in de parameter Path.
Type: | String |
Positie: | 1 |
Standaardwaarde: | Geen |
Accepteer invoer pijplijn: | True (ByPropertyName) |
Accepteer wildcard tekens: | False |
Optionele parameters
Vraagt u om bevestiging voordat u het cmdlet uitvoert.Vraagt u om bevestiging voordat u het cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Positie: | Named |
Standaardwaarde: | False |
Accepteer invoer pijplijn: | False |
Accepteer wildcard tekens: | False |
Specificeert een gebruikersaccount dat toestemming heeft om deze actie uit te voeren.De standaard is de huidige gebruiker.
Typ een gebruikersnaam, zoals “User01” of “Domain01User01”, of voer een PSCredential object in, zoals een gegenereerd door het cmdlet Get-Credential.Indien u een gebruikersnaam typt, zal u om een wachtwoord worden gevraagd.
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met Windows PowerShell
Type: | PSCredential |
Positie: | Named |
Standaardwaarde: | Geen |
Accepteer invoer pijplijn: | True (ByPropertyName) |
Accepteer wildcard tekens: | False |
Hiermee kan het cmdlet een item aanmaken dat schrijft over een bestaand alleen-lezen item.Implementatie varieert van provider tot provider.Voor meer informatie, zie about_Providers.Zelfs met gebruik van de Force parameter, kan het cmdlet de beveiligingsrestricties niet opheffen.
Type: | SwitchParameter |
Positie: | Genoemd |
Standaardwaarde: | Geen |
Accepteer invoer pijplijn: | False |
Accepteer wildcard tekens: | False |
Inclusief de opdracht in de actieve transactie.Deze parameter is alleen geldig als een transactie aan de gang is.Voor meer informatie, zie
Type: | SwitchParameter |
Aliassen: | usetx |
Positie: | Named |
Standaardwaarde: | False |
Accepteer invoer pijplijn: | False |
Accepteer wildcard tekens: | False |
Specificeert de waarde van het nieuwe item.U kunt ook een waarde naar New-Item pijpen.
Type: | Object |
Positie: | Genoemd |
Standaardwaarde: | Geen |
Accepteer invoer pijplijn: | True (ByPropertyName, ByValue) |
Accepteer wildcard-tekens: | False |
Toont wat er zou gebeuren als het cmdlet wordt uitgevoerd.Het cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Positie: | Named |
Standaardwaarde: | False |
Accepteer invoer pijplijn: | False |
Accepteer wildcard tekens: | False |
Inputs
System.Object
U kunt een waarde voor het nieuwe item naar het cmdlet New-Item leiden.
Uitvoer
System.Object
New-Item retourneert het item dat het maakt.
Notes
Het cmdlet New-Item is ontworpen om te werken met de gegevens die door elke provider worden aangeboden.Om een lijst met providers op te vragen die in uw sessie beschikbaar zijn, typt u “Get-PsProvider”.Voor meer informatie, zie about_Providers.
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers