Delen via

New-Item

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee maakt u een nieuw item.

Syntaxis

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

Description

De cmdlet New-Item maakt een nieuw item en stelt de waarde ervan in. De typen items die kunnen worden gemaakt, zijn afhankelijk van de locatie van het item. In het bestandssysteem maakt New-Item bijvoorbeeld bestanden en mappen. In het register maakt New-Item registersleutels en vermeldingen.

New-Item kunt ook de waarde instellen van de items die worden gemaakt. Wanneer er bijvoorbeeld een nieuw bestand wordt gemaakt, kan New-Item initiële inhoud toevoegen aan het bestand.

Voorbeelden

Voorbeeld 1: Een bestand maken in de huidige map

Met deze opdracht maakt u een tekstbestand met de naam 'testfile1.txt' in de huidige map. De punt ('.') in de waarde van de parameter Path geeft de huidige map aan. De tekst tussen aan citeren die volgt op de parameter Waarde wordt als inhoud aan het bestand toegevoegd.

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

Voorbeeld 2: Een map maken

Met deze opdracht maakt u een map met de naam 'Logfiles' in het C: station. De parameter ItemType geeft aan dat het nieuwe item een map is, niet een bestand of een ander bestandssysteemobject.

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

Voorbeeld 3: Een profiel maken

Met deze opdracht maakt u een PowerShell-profiel in het pad dat is opgegeven door de $profile variabele.

U kunt profielen gebruiken om PowerShell aan te passen. $profile is een automatische (ingebouwde) variabele waarin het pad en de bestandsnaam van het profiel CurrentUser/CurrentHost worden opgeslagen. Het profiel bestaat standaard niet, ook al slaat PowerShell er een pad en bestandsnaam voor op.

In deze opdracht vertegenwoordigt de variabele $profile het pad van het bestand. Parameter ItemType geeft aan dat de opdracht een bestand maakt. Met de parameter Forceren kunt u een bestand maken in het profielpad, zelfs als de mappen in het pad niet bestaan.

Nadat u een profiel hebt gemaakt, kunt u aliassen, functies en scripts in het profiel invoeren om uw shell aan te passen.

Zie about_Automatic_Variables en about_Profilesvoor meer informatie.

New-Item -Path $profile -ItemType "file" -Force

Notitie

Wanneer u een bestand maakt met deze methode, wordt het resulterende bestand gecodeerd als UTF-8 zonder byte-order-mark (BOM).

Voorbeeld 4: Een map maken in een andere map

In dit voorbeeld wordt een nieuwe map Scripts gemaakt in de map C:\PS-Test.

De naam van het nieuwe mapitem , 'Scripts', wordt opgenomen in de waarde van parameter Path, in plaats van te worden opgegeven in de waarde van Name. Zoals aangegeven door de syntaxis, is een van beide opdrachtformulieren geldig.

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

Voorbeeld 5: Meerdere bestanden maken

In dit voorbeeld worden bestanden in twee verschillende mappen gemaakt. Omdat Pad meerdere tekenreeksen gebruikt, kunt u deze gebruiken om meerdere items te maken.

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

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Notitie

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Hiermee dwingt u deze cmdlet om een item te maken dat over een bestaand alleen-lezenitem schrijft. Implementatie varieert van provider tot provider. Zie about_Providersvoor meer informatie. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen overschrijven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ItemType

Hiermee geeft u het door de provider opgegeven type van het nieuwe item. De beschikbare waarden van deze parameter zijn afhankelijk van de huidige provider die u gebruikt.

Als uw locatie zich in een FileSystem station bevindt, zijn de volgende waarden toegestaan:

  • Bestand
  • Map
  • Symbolische koppeling
  • Aansluiting
  • HardLink

Wanneer u een bestand maakt met deze methode, wordt het resulterende bestand gecodeerd als UTF-8 zonder byte-order-mark (BOM).

In een Certificate station zijn dit de waarden die u kunt opgeven:

  • Certificaatprovider
  • Certificaat
  • Winkel
  • StoreLocation

Zie about_Providersvoor meer informatie.

Type:String
Aliassen:Type
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van het nieuwe item.

U kunt de naam van het nieuwe item opgeven in het Name of Path parameterwaarde en u kunt het pad van het nieuwe item opgeven in naam of pad waarde.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad van de locatie van het nieuwe item. Jokertekens zijn toegestaan.

U kunt de naam van het nieuwe item opgeven in Naamof opnemen in Pad.

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Value

Hiermee geeft u de waarde van het nieuwe item. U kunt ook een waarde doorspezen naar New-Item.

Type:Object
Aliassen:Target
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Object

U kunt een waarde voor het nieuwe item doorsluisen naar deze cmdlet.

Uitvoerwaarden

Object

Met deze cmdlet wordt het item geretourneerd dat wordt gemaakt.

Notities

New-Item is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PsProvider. Zie about_Providersvoor meer informatie.