Set-Item
Hiermee wijzigt u de waarde van een item in de waarde die is opgegeven in de opdracht.
Syntax
Set-Item
[-Path] <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Item
-LiteralPath <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Set-Item
cmdlet wijzigt de waarde van een item, zoals een variabele of registersleutel, in de waarde die is opgegeven in de opdracht.
Voorbeelden
Voorbeeld 1: Een alias maken
Met deze opdracht maakt u een alias van np voor Kladblok.
Set-Item -Path alias:np -Value "c:\windows\notepad.exe"
Voorbeeld 2: De waarde van een omgevingsvariabele wijzigen
Met deze opdracht wijzigt u de waarde van de omgevingsvariabele UserRole in Administrator.
Set-Item -Path env:UserRole -Value "Administrator"
Voorbeeld 3: De promptfunctie wijzigen
Met deze opdracht wordt de promptfunctie gewijzigd, zodat deze de tijd vóór het pad weergeeft.
Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}
Voorbeeld 4: Opties instellen voor de promptfunctie
Met deze opdracht stelt u de opties AllScope en ReadOnly in voor de promptfunctie.
Deze opdracht maakt gebruik van de dynamische parameter Opties van Set-Item
.
De parameter Opties is alleen beschikbaar Set-Item
wanneer u deze gebruikt bij de alias - of functieprovider .
Set-Item -Path function:prompt -Options "AllScope,ReadOnly"
Parameters
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Hiermee geeft u, als tekenreeksmatrix, een item of items op die door deze cmdlet worden uitgesloten in de bewerking. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt
. Jokertekens zijn toegestaan. De parameter Uitsluiten is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*
, waarbij het jokerteken de inhoud van de C:\Windows
map aangeeft.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Hiermee geeft u een filter op om de path-parameter te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die ondersteuning biedt voor het gebruik van filters. U vindt de syntaxis voor de filtertaal Bestandssysteem in about_Wildcards. Filters zijn efficiënter dan andere parameters, omdat de provider ze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Hiermee dwingt u de cmdlet om items in te stellen die anders niet kunnen worden gewijzigd, zoals alleen-lezenalias of variabelen. De cmdlet kan geen constante aliassen of variabelen wijzigen. Implementatie varieert van provider tot provider. Zie about_Providers voor meer informatie. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen overschrijven.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Hiermee geeft u, als tekenreeksmatrix, een item of items op die deze cmdlet bevat in de bewerking. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals "*.txt"
. Jokertekens zijn toegestaan. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*
, waarbij het jokerteken de inhoud van de C:\Windows
map aangeeft.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt exact gebruikt terwijl deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat u geen tekens als escape-reeksen interpreteert.
Zie about_Quoting_Rules voor meer informatie.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Hiermee geeft u een object door dat het item aan de pijplijn vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Hiermee geeft u een pad op van de locatie van de items. Jokertekens zijn toegestaan.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Value
Hiermee geeft u een nieuwe waarde voor het item op.
Type: | Object |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een object doorsluisen dat de nieuwe waarde van het item aan deze cmdlet vertegenwoordigt.
Uitvoerwaarden
None or an object representing the new or changed item.
Met deze cmdlet wordt een object gegenereerd dat het item vertegenwoordigt, als u de parameter PassThru opgeeft. Anders genereert deze cmdlet geen uitvoer.
Notities
Set-Item
wordt niet ondersteund door de PowerShell-bestandssysteemprovider. Gebruik deSet-Content
cmdlet om de waarden van items in het bestandssysteem te wijzigen.- Wijzig de gegevens in de registerstations
HKLM:
enHKCU:
Set-Item
wijzigt de gegevens in de waarde (standaard) van een registersleutel.- Als u de namen van registersleutels wilt maken en wijzigen, gebruikt u de
New-Item
enRename-Item
cmdlet. - Als u de namen en gegevens in registerwaarden wilt wijzigen, gebruikt u de
New-ItemProperty
,Set-ItemProperty
enRename-ItemProperty
cmdlets.
- Als u de namen van registersleutels wilt maken en wijzigen, gebruikt u de
Set-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 uGet-PsProvider
. Zie about_Providers voor meer informatie.