Set-Item

Syntax

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

Exempel

Exempel 1: Skapa ett alias

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

Exempel 2: Ändra värdet för en miljövariabel

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

Exempel 3: Ändra promptfunktionen

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

Exempel 4: Ange alternativ för din promptfunktion

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Parameteruppsättningar

-Credential

Parameteregenskaper

Parameteruppsättningar

-Exclude

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten exkluderar i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts. Parametern Exclude gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

Parameteregenskaper

Parameteruppsättningar

-Filter

Anger ett filter för att kvalificera parametern Path. FileSystem-providern är den enda installerade PowerShell-providern som stöder användning av filter. Du hittar syntaxen för FileSystem filterspråk i about_Wildcards. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när cmdleten hämtar objekten i stället för att Låta PowerShell filtrera objekten när de har hämtats.

Parameteregenskaper

Parameteruppsättningar

-Force

Tvingar cmdleten att ange objekt som annars inte kan ändras, till exempel skrivskyddat alias eller variabler. Cmdleten kan inte ändra konstanta alias eller variabler. Implementeringen varierar från leverantör till leverantör. Mer information finns i om_Leverantörer. Även om du använder parametern Force kan cmdleten inte åsidosätta säkerhetsbegränsningar.

Parameteregenskaper

Parameteruppsättningar

-Include

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel "*.txt". Jokertecken tillåts. Parametern Include gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.

Parameteregenskaper

Parameteruppsättningar

-LiteralPath

Anger en sökväg till en eller flera platser. Värdet för LiteralPath används exakt som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Parameteregenskaper

Parameteruppsättningar

-Options

Det här är en dynamisk parameter som görs tillgänglig av Alias och Function providers. Mer information finns i about_Alias_Provider och about_Function_Provider.

Anger värdet för egenskapen Alternativ för ett alias.

Giltiga värden är:

• None: Aliaset har inga begränsningar (standardvärde)
• ReadOnly: Aliaset kan tas bort men kan inte ändras utan att använda parametern Force
• Constant: Aliaset kan inte tas bort eller ändras
• Private: Aliaset är endast tillgängligt i det aktuella omfånget
• AllScope: Aliaset kopieras till alla nya omfång som skapas
• Unspecified: Alternativet har inte angetts

Parameteregenskaper

Parameteruppsättningar

-PassThru

Skickar ett objekt som representerar objektet till pipelinen. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Parameteruppsättningar

-Path

Anger en sökväg för objektens plats. Jokertecken tillåts.

Parameteregenskaper

Parameteruppsättningar

-Type

Det här är en dynamisk parameter som görs tillgänglig av providern Registry. Providern Registry och den här parametern är endast tillgängliga i Windows.

Anger vilken typ av egenskap som den här cmdleten lägger till. De godtagbara värdena för den här parametern är:

• String: Anger en null-avslutad sträng. Används för REG_SZ värden.
• ExpandString: Anger en null-avslutad sträng som innehåller oexpandererade referenser till miljövariabler som expanderas när värdet hämtas. Används för värden av typen REG_EXPAND_SZ.
• Binary: Anger binära data i valfri form. Används för REG_BINARY värden.
• DWord: Anger ett 32-bitars binärt tal. Används för REG_DWORD värden.
• MultiString: Anger en matris med null-avslutade strängar som avslutas med två null-tecken. För värden av typen REG_MULTI_SZ använder man .
• Qword: Anger ett 64-bitars binärt tal. Används för REG_QWORD-värden.
• Unknown: Anger en registerdatatyp som inte stöds, till exempel REG_RESOURCE_LIST värden.

Parameteregenskaper

Parameteruppsättningar

-Value

Anger ett nytt värde för objektet.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

Object

Utdata

None

Object

Kommentarer

Relaterade länkar

• Rensa-Objekt
• Kopiera-Objekt
• Hämta objekt
• Invoke-Item
• Flytta-Objekt
• Skapa-NyttObjekt
• Ta bort-Objekt
• Byt namn på objekt
• om Leverantörer