Set-Item

Syntaxis

Path (Default) - All providers

Set-Item
    [-Path] <String[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Set-Item
    [[-Value] <Object>]
    -LiteralPath <String[]>
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Path (Default) - Alias and Function providers

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

LiteralPath - Alias and Function providers

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

Path (Default) - Registry provider

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

LiteralPath - Registry provider

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: Een alias maken

Set-Item -Path Alias:np -Value "C:\windows\notepad.exe"

Voorbeeld 2: de waarde van een omgevingsvariabele wijzigen

Set-Item -Path Env:UserRole -Value "Administrator"

Voorbeeld 3: De promptfunctie wijzigen

Set-Item -Path Function:prompt -Value {
    'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '
}

Voorbeeld 4: Opties instellen voor de promptfunctie

Set-Item -Path Function:prompt -Options "AllScope,ReadOnly"

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-Credential

Parametereigenschappen

Parametersets

-Exclude

Hiermee specificeert u, als een tekenreeks, één of meerdere items die door deze cmdlet worden uitgesloten van de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Path. 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.

Parametereigenschappen

Parametersets

-Filter

Hiermee geeft u een filter op om de parameter Path te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die het gebruik van filters ondersteunt. U kunt de syntaxis voor de FileSystem filtertaal vinden in about_Wildcards. Filters zijn efficiënter dan andere parameters, omdat de provider deze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.

Parametereigenschappen

Parametersets

-Force

Hiermee dwingt u af dat de cmdlet items instelt die anders niet kunnen worden gewijzigd, zoals een alleen-lezen alias of variabelen. De cmdlet kan geen constante aliassen of variabelen wijzigen. Implementatie varieert van provider tot provider. Zie about_Providersvoor meer informatie. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen overschrijven.

Parametereigenschappen

Parametersets

-Include

Hiermee specificeert u, in de vorm van een tekenreeksarray, een item of items die deze cmdlet bij de bewerking betrekt. De waarde van deze parameter komt in aanmerking voor de parameter Path. 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.

Parametereigenschappen

Parametersets

-LiteralPath

Specificeert een pad naar een of meer locaties. De waarde van LiteralPath- wordt exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.

Zie about_Quoting_Rulesvoor meer informatie.

Parametereigenschappen

Parametersets

-Options

Dit is een dynamische parameter die beschikbaar wordt gesteld door de Alias en Function providers. Zie about_Alias_Provider en about_Function_Providervoor 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

Parametersets

-PassThru

Geeft een object door dat het item aan de pijplijn voorstelt. Deze cmdlet genereert standaard geen uitvoer.

Parametereigenschappen

Parametersets

-Path

Specificeert het pad naar de locatie van de items. Jokertekens zijn toegestaan.

Parametereigenschappen

Parametersets

-Type

Dit is een dynamische parameter die beschikbaar wordt gesteld door de Registry provider. De Register--provider en deze parameter zijn alleen beschikbaar in Windows.

Hiermee geeft u het type eigenschap op dat door deze cmdlet wordt toegevoegd. De acceptabele waarden voor deze parameter zijn:

• String: hiermee geeft u een tekenreeks met null-beëindiging op. Wordt gebruikt voor REG_SZ waarden.
• ExpandString: hiermee geeft u een tekenreeks met null-beëindiging op die niet-uitgevouwen verwijzingen bevat naar omgevingsvariabelen die worden uitgevouwen wanneer de waarde wordt opgehaald. Wordt gebruikt voor REG_EXPAND_SZ waarden.
• Binary: hiermee geeft u binaire gegevens in elke vorm op. Wordt gebruikt voor REG_BINARY waarden.
• DWord: hiermee geeft u een 32-bits binair getal op. Wordt gebruikt voor REG_DWORD waarden.
• MultiString: Hiermee specificeert u een array van null-beëindigde tekenreeksen, afgesloten met twee null-tekens. Wordt gebruikt voor REG_MULTI_SZ waarden.
• Qword: hiermee geeft u een 64-bits binair getal op. Wordt gebruikt voor REG_QWORD waarden.
• Unknown: geeft een niet-ondersteund registergegevenstype aan, zoals REG_RESOURCE_LIST waarden.

Parametereigenschappen

Parametersets

-Value

Hiermee geeft u een nieuwe waarde voor het item.

Parametereigenschappen

Parametersets

-WhatIf

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

Object

Uitvoerwaarden

None

Object

Notities

Verwante koppelingen

• Maak-item leeg
• Kopieer-Item
• Get-Item
• Invoke-Item
• Move-Item
• Nieuw-Item
• Remove-Item
• Hernoem-Object
• about_Aanbieders