Set-Item
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étrehoz egy np aliast a Jegyzettömbhöz.
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 rendszergazdaként módosítja a UserRole környezeti változó értékét.
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-Item
haszná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.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Aliasok: | PSPath, LP |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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ő elAllScope
: Az alias át lesz másolva a létrehozott új hatókörökbeUnspecified
: A beállítás nincs megadva
Típus: | ScopedItemOptions |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PassThru
Átad egy objektumot, amely az elemet jelöli a folyamatnak. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Path
Megadja az elemek helyének elérési útját. A helyettesítő karakterek használata engedélyezett.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | RegistryValueKind |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Value
Új értéket ad meg az elemhez.
Típus: | Object |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
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.
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-Item
tartalmazza:
Ö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 aSet-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
ésRename-ItemProperty
a parancsmagokat.
- A beállításkulcsok nevének létrehozásához és módosításához használja a
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őtGet-PsProvider
: További információ: about_Providers.