Set-Item

  • Referencia
Modul:
Microsoft.PowerShell.Management

Egy elem értékét a parancsban megadott értékre módosítja.

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>]
Set-Item
   [-Path] <string[]>
   [[-Value] <Object>]
   [-Force]
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]
Set-Item
   [[-Value] <Object>]
   -LiteralPath <string[]>
   [-Force]
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]
Set-Item
   [-Path] <string[]>
   [[-Value] <Object>]
   [-Force]
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]
Set-Item
   [[-Value] <Object>]
   -LiteralPath <string[]>
   [-Force]
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Type <RegistryValueKind>]
   [<CommonParameters>]

Description

A Set-Item parancsmag egy elem( például változó vagy beállításkulcs) értékét a parancsban megadott értékre módosítja.

Példák

1. példa: Alias létrehozása

Ez a parancs létrehozza az np aliasát Jegyzettömb számára.

Set-Item -Path alias:np -Value "c:\windows\notepad.exe"

2. példa: Környezeti változó értékének módosítása

Ez a parancs a UserRole környezeti változó értékét Rendszergazda istrator értékre módosítja.

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

3. példa: A parancssori függvény módosítása

Ez a parancs úgy módosítja a parancssori függvényt, hogy megjeleníti az elérési út előtti időt.

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

4. példa: A parancssori függvény beállításainak megadása

Ez a parancs beállítja a parancssori függvény AllScope és ReadOnly beállításait. Ez a parancs a Beállítások dinamikus paraméterét Set-Itemhasználja. A Beállítások paraméter csak akkor érhető elSet-Item, ha az Alias vagy a Függvényszolgáltatóval használja.

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

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Feljegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket ez a parancsmag kizár a műveletből. Ennek a paraméternek az értéke az Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például *.txt. A helyettesítő karakterek használata engedélyezett. A Kizárás paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*ha a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Egy szűrőt ad meg, amely megfelel az Elérési út paraméternek. A Fájlrendszer-szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A Fájlrendszer szűrőnyelvének szintaxisa about_Wildcards található. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat, és nem azt, hogy a PowerShell szűrje az objektumokat a lekérés után.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Kényszeríti a parancsmagot olyan elemek beállítására, amelyek egyébként nem módosíthatók, például írásvédett aliasok vagy változók. A parancsmag nem módosíthatja az állandó aliasokat vagy változókat. A megvalósítás szolgáltatónként eltérő. További információ: about_Providers. A Parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Sztringtömbként egy elemet vagy elemet határoz meg, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke az Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*amikor a helyettesítő karakter a könyvtár tartalmát C:\Windows adja meg.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Egy vagy több hely elérési útját adja meg. A LiteralPath értékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

További információ: about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Options

Ez egy dinamikus paraméter, amelyet az Alias és a Függvényszolgáltatók tettek elérhetővé. További információ: about_Alias_Provider és about_Function_Provider.

Egy alias Beállítások tulajdonságának értékét adja meg.

Az érvényes értékek a következők:

  • None: Az alias nem rendelkezik korlátozásokkal (alapértelmezett érték)
  • ReadOnly: Az alias törölhető, de a Force paraméter használata nélkül nem módosítható
  • Constant: Az alias nem törölhető vagy módosítható
  • Private: Az alias csak az aktuális hatókörben érhető el
  • AllScope: Az alias át lesz másolva a létrehozott új hatókörökbe
  • Unspecified: A beállítás nincs megadva
Type:ScopedItemOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Átad egy objektumot, amely az elemet jelöli a folyamatnak. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Megadja az elemek helyének elérési útját. A helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Type

Ez a beállításjegyzék-szolgáltató által elérhetővé tett dinamikus paraméter. A beállításjegyzék-szolgáltató és ez a paraméter csak Windows rendszeren érhető el.

Megadja a parancsmag által hozzáadott tulajdonság típusát. A paraméter elfogadható értékei a következők:

  • String: Null értékű sztringet ad meg. REG_SZ értékekhez használatos.
  • ExpandString: Null értékű sztringet ad meg, amely az érték lekérésekor kibontott környezeti változókra mutató nem létező hivatkozásokat tartalmaz. REG_EXPAND_SZ értékekhez használatos.
  • Binary: Bináris adatokat határoz meg bármilyen formában. REG_BINARY értékekhez használatos.
  • DWord: 32 bites bináris számot ad meg. REG_DWORD értékekhez használatos.
  • MultiString: A null értékű sztringek két null karakterrel végződő tömbét adja meg. REG_MULTI_SZ értékekhez használatos.
  • Qword: 64 bites bináris számot ad meg. REG_QWORD értékekhez használatos.
  • Unknown: Nem támogatott beállításjegyzék-adattípust jelöl, például REG_RESOURCE_LIST értékeket.
Type:RegistryValueKind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Value

Új értéket ad meg az elemhez.

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

Object

A parancsmagra az elem új értékét képviselő objektumot csövezheti.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

Object

A PassThru paraméter használatakor ez a parancsmag egy, az elemet képviselő objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Set-Itemtartalmazza:

  • Összes platform:

    • si

  • Set-Item a PowerShell Fájlrendszer szolgáltató nem támogatja. A fájlrendszer elemeinek értékeinek módosításához használja a Set-Content parancsmagot.

  • A beállításjegyzék-meghajtókon HKLM:HKCU:Set-Item módosítsa a beállításkulcs (alapértelmezett) értékének adatait.

    • A beállításkulcsok nevének létrehozásához és módosításához használja a New-Item parancsmagot.Rename-Item
    • A beállításjegyzék-értékekben szereplő nevek és adatok módosításához használja a New-ItemProperty, Set-ItemPropertyés Rename-ItemProperty a parancsmagokat.

  • Set-Item úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a következőt Get-PsProvider: További információ: about_Providers.