New-Item
Hiermee maakt u een nieuw item.
Syntax
pathSet (Default) - All providers
New-Item
[-Path] <string[]>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
nameSet - All providers
New-Item
[[-Path] <string[]>]
-Name <string>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
pathSet (Default) - WSMan provider
New-Item
[-Path] <string[]>
-ConnectionURI <uri>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-OptionSet <hashtable>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <string>]
[-SessionOption <SessionOption>]
[-Port <int>]
[<CommonParameters>]
nameSet - WSMan provider
New-Item
[[-Path] <string[]>]
-Name <string>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-OptionSet <hashtable>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <string>]
[-SessionOption <SessionOption>]
[-ApplicationName <string>]
[-Port <int>]
[-UseSSL]
[<CommonParameters>]
pathSet (Standaard)
New-Item
[-Path] <string[]>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
nameSet
New-Item
[[-Path] <string[]>]
-Name <string>
[-ItemType <string>]
[-Value <Object>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<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
Opmerking
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"
Voorbeeld 6: Jokertekens gebruiken om bestanden in meerdere mappen te maken
De New-Item-cmdlet ondersteunt jokertekens in de parameter Path. Met de volgende opdracht maakt u een temp.txt bestand in alle mappen die zijn opgegeven door de jokertekens in de parameter Path.
Get-ChildItem -Path C:\Temp\
Directory: C:\Temp
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 5/15/2019 6:45 AM 1 One
d----- 5/15/2019 6:45 AM 1 Two
d----- 5/15/2019 6:45 AM 1 Three
New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName
FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt
De Get-ChildItem-cmdlet bevat drie mappen onder de map C:\Temp. Met jokertekens maakt de New-Item-cmdlet een temp.txt-bestand in alle mappen onder de huidige map. De New-Item-cmdlet voert de items uit die u hebt gemaakt. Deze wordt doorgesluisd naar Select-Object om de paden van de zojuist gemaakte bestanden te controleren.
Voorbeeld 7: Een symbolische koppeling naar een bestand of map maken
In dit voorbeeld wordt een symbolische koppeling gemaakt naar het Notice.txt bestand in de huidige map.
$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target
LinkType Target
-------- ------
SymbolicLink {.\Notice.txt}
In dit voorbeeld is Doel- een alias voor de parameter Waarde. Het doel van de symbolische koppeling moet een volledig gekwalificeerd pad zijn.
Voorbeeld 8: Gebruik de parameter -Force om mappen opnieuw te maken
In dit voorbeeld wordt een map gemaakt met een bestand erin. Vervolgens probeert u dezelfde map te maken met behulp van -Force. De map wordt niet overschreven, maar retourneert gewoon het bestaande mapobject met het bestand dat is gemaakt.
PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File
PS> New-Item -Path .\TestFolder -ItemType Directory -Force
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 5/1/2020 8:03 AM TestFolder
PS> Get-ChildItem .\TestFolder\
Directory: C:\TestFolder
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:03 AM 0 TestFile.txt
Voorbeeld 9: Gebruik de parameter -Force om bestaande bestanden te overschrijven
In dit voorbeeld wordt een bestand met een waarde gemaakt en wordt het bestand vervolgens opnieuw gemaakt met behulp van -Force. Hiermee wordt het bestaande bestand overschreven, zoals u kunt zien door de eigenschap Length.
PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'
Directory: C:\Source\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:32 AM 24 TestFile.txt
New-Item ./TestFile.txt -ItemType File -Force
Directory: C:\Source\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 5/1/2020 8:32 AM 0 TestFile.txt
Opmerking
Wanneer u New-Item gebruikt met de -Force overschakelt om registersleutels te maken, gedraagt de opdracht zich hetzelfde als bij het overschrijven van een bestand. Als de registersleutel al bestaat, worden de sleutel en alle eigenschappen en waarden overschreven met een lege registersleutel.
Parameters
-ApplicationName
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u de naam van de toepassing in de verbinding. De standaardwaarde van de parameter ApplicationName is WSMAN-.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
nameSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Authentication
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u het verificatiemechanisme dat moet worden gebruikt op de server.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | AuthenticationMechanism |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-CertificateThumbprint
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is om deze WSMan-actie uit te voeren. Voer de vingerafdruk van het certificaat in.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ConnectionURI
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u het verbindingseindpunt voor WSMan.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | Uri |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
pathSet
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Credential
Opmerking
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.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | Current user |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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. Zelfs met behulp van de Force parameter kan de cmdlet geen beveiligingsbeperkingen overschrijven.
U kunt Force niet gebruiken om een bestaande verbinding te overschrijven. Pogingen om een bestaande verbinding te overschrijven, mislukken met de fout 'kan niet worden verwijderd omdat deze niet leeg is'. U moet de bestaande verbinding verwijderen voordat u een nieuwe maakt.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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:
FileDirectorySymbolicLinkJunctionHardLink
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:
Certificate ProviderCertificateStoreStoreLocation
Zie about_Providersvoor meer informatie.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Typologie |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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. Namen van items die worden doorgegeven met behulp van de parameter Name worden gemaakt ten opzichte van de waarde van de parameter Path.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
nameSet
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Options
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Alias provider. Zie New-Aliasvoor meer informatie.
Hiermee geeft u de waarde op van de eigenschap Options van een alias.
Geldige waarden zijn:
-
None: de alias heeft geen beperkingen (standaardwaarde) -
ReadOnly: de alias kan worden verwijderd, maar kan niet worden gewijzigd zonder de parameter Force te gebruiken -
Constant: de alias kan niet worden verwijderd of gewijzigd -
Private: de alias is alleen beschikbaar in het huidige bereik -
AllScope: De alias wordt gekopieerd naar elke nieuwe scope die wordt gemaakt -
Unspecified: de optie is niet opgegeven
Parametereigenschappen
| Type: | ScopedItemOptions |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-OptionSet
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee wordt een set switches doorgegeven aan een service om de aard van de aanvraag te wijzigen of te verfijnen.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | Hashtable |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | besturingssysteem |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Path
Hiermee geeft u het pad van de locatie van het nieuwe item. De standaardwaarde is de huidige locatie wanneer pad wordt weggelaten. U kunt de naam van het nieuwe item opgeven in Naamof opnemen in Pad. Namen van items die worden doorgegeven met behulp van de parameter Name worden gemaakt ten opzichte van de waarde van de parameter Path.
Voor deze cmdlet werkt de parameter Path als de parameter LiteralPath van andere cmdlets.
Jokertekens worden niet geïnterpreteerd. Alle tekens worden doorgegeven aan de provider van de locatie. De provider ondersteunt mogelijk niet alle tekens. U kunt bijvoorbeeld geen bestandsnaam maken die een sterretje (*) bevat.
Parametereigenschappen
| Type: | String[] |
| Default value: | Current location |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
pathSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
nameSet
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Port
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u de poort op die moet worden gebruikt wanneer de client verbinding maakt met de WinRM-service.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-SessionOption
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee definieert u een set uitgebreide opties voor de WS-Management sessie.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | SessionOption |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | SO |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-UseSSL
Dit is een dynamische parameter die beschikbaar wordt gesteld door de WSMan provider. De WSMan provider en deze parameter zijn alleen beschikbaar in Windows.
Hiermee geeft u op dat het SSL-protocol (Secure Sockets Layer) moet worden gebruikt om een verbinding met de externe computer tot stand te brengen. SSL wordt standaard niet gebruikt.
Zie New-WSManInstancevoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
nameSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-UseTransaction
Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | usetx |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Value
Hiermee geeft u de waarde van het nieuwe item. U kunt ook een waarde doorspezen naar New-Item.
Parametereigenschappen
| Type: | Object |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Target |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
Object
U kunt een waarde voor het nieuwe item doorsluisen naar deze cmdlet.
Uitvoerwaarden
DictionaryEntry
De cmdlet retourneert een DictionaryEntry-object bij het maken van een nieuwe omgevingsvariabele.
DirectoryInfo
De cmdlet retourneert een DirectoryInfo--object bij het maken van een nieuwe map in het bestandssysteem.
FileInfo
De cmdlet retourneert een FileInfo--object bij het maken van een nieuw bestand in het bestandssysteem.
AliasInfo
De cmdlet retourneert een AliasInfo--object bij het maken van een nieuwe alias.
FunctionInfo
De cmdlet retourneert een FunctionInfo--object bij het maken van een nieuwe functie.
PSVariable
De cmdlet retourneert een PSVariable-object bij het maken van een nieuwe variabele.
Notities
Windows PowerShell bevat de volgende aliassen voor New-Item:
ni
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.
