Set-ItemProperty
Egy elem tulajdonságának értékét hozza létre vagy módosítja.
Syntax
propertyValuePathSet (Alapértelmezett)
Set-ItemProperty
[-Path] <String[]>
[-Name] <String>
[-Value] <Object>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
propertyPSObjectPathSet
Set-ItemProperty
[-Path] <String[]>
-InputObject <PSObject>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
propertyValueLiteralPathSet
Set-ItemProperty
[-Name] <String>
[-Value] <Object>
-LiteralPath <String[]>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
propertyPSObjectLiteralPathSet
Set-ItemProperty
-LiteralPath <String[]>
-InputObject <PSObject>
[-PassThru]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
A Set-ItemProperty parancsmag módosítja a megadott elem tulajdonságának értékét.
A parancsmaggal létrehozhatja vagy módosíthatja az elemek tulajdonságait.
A Set-ItemProperty például beállíthatja egy fájlobjektum IsReadOnly tulajdonságának értékét $True.
A beállításjegyzék értékeinek és adatainak létrehozásához és módosításához Set-ItemProperty is használható.
Hozzáadhat például egy új beállításjegyzék-bejegyzést egy kulcshoz, és létrehozhatja vagy módosíthatja annak értékét.
Példák
1. példa: Fájl tulajdonságának beállítása
Ez a parancs a "final.doc" fájl IsReadOnly tulajdonságának értékét "true" értékre állítja. A Elérési út használatával adja meg a fájlt, Név a tulajdonság nevének megadásához, az új érték megadásához pedig a Érték paramétert.
A fájl egy System.IO.FileInfo objektum, és IsReadOnly csak az egyik tulajdonsága.
Az összes tulajdonság megtekintéséhez írja be a Get-Item C:\GroupFiles\final.doc | Get-Member -MemberType Property.
Az $true automatikus változó a "TRUE" értéket jelöli.
További információért tekintse meg az *about_Automatic_Variables* témakört a éscímkék alatt.
Set-ItemProperty -Path C:\GroupFiles\final.doc -Name IsReadOnly -Value $true
2. példa: Beállításjegyzék-bejegyzés és -érték létrehozása
Ez a példa bemutatja, hogyan hozhat létre új beállításjegyzék-bejegyzést Set-ItemProperty, és hogyan rendelhet hozzá értéket a bejegyzéshez.
Létrehozza a "NoOfEmployees" bejegyzést a "ContosoCompany" kulcsban a "HKLM\Software" kulcsban, és 823-ra állítja az értékét.
Mivel a beállításjegyzék-bejegyzéseket a beállításkulcsok tulajdonságainak tekintik, amelyek elemek, a beállításjegyzékbejegyzések létrehozásához és az értékek létrehozásához és módosításához használja a Set-ItemProperty.
Az első parancs létrehozza a beállításjegyzék-bejegyzést.
A Path használatával adja meg a HKLM: meghajtó elérési útját és a "Software\MyCompany" kulcsot.
A parancs Név használatával adja meg a bejegyzés nevét, az érték megadásához pedig Érték.
A második parancs a Get-ItemProperty parancsmaggal látja az új beállításjegyzék-bejegyzést.
Ha a Get-Item vagy Get-ChildItem parancsmagokat használja, a bejegyzések nem jelennek meg, mert kulcs tulajdonságai, nem elemek vagy gyermekelemek.
A harmadik parancs a NoOfEmployees bejegyzés értékét 824-esre módosítja.
Az New-ItemProperty parancsmaggal is létrehozhatja a beállításjegyzék-bejegyzést és annak értékét, majd Set-ItemProperty használatával módosíthatja az értéket.
A HKLM: meghajtóval kapcsolatos további információkért írja be a Get-Help Get-PSDrive.
Ha többet szeretne tudni arról, hogyan kezelheti a beállításjegyzéket a PowerShell használatával, írja be a Get-Help Registry.
Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 823
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\contosocompany
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName : contosocompany
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 823
Set-ItemProperty -Path "HKLM:\Software\ContosoCompany" -Name "NoOfEmployees" -Value 824
Get-ItemProperty -Path "HKLM:\Software\ContosoCompany"
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\contosocompany
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName : contosocompany
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 824
3. példa: Elem módosítása a folyamat használatával
Ezek a parancsok bemutatják, hogyan lehet folyamatkezelőt (|) használni egy elem elküldéséhez Set-ItemProperty.
A parancs első része Get-ChildItem használ egy objektum lekéréséhez, amely a "Weekly.txt" fájlt jelöli.
A parancs folyamatkezelővel küldi el a fájlobjektumot Set-ItemProperty.
A Set-ItemProperty parancs a Név és Érték paramétereket használja a tulajdonság és az új érték megadásához.
Ez a parancs egyenértékű a InputObject paraméterrel a Get-ChildItem lekérendő objektum megadásához.
Get-ChildItem weekly.txt | Set-ItemProperty -Name IsReadOnly -Value $True
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, a rendszer jelszót kér.
Figyelmeztetés
Ezt a paramétert a Windows PowerShell-lel telepített szolgáltatók nem támogatják.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Megadja azokat az elemeket, amelyeken a parancsmag nem működik, és az összes többit is tartalmazza. Ennek a paraméternek az értéke a 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a Elérési út paramétert minősíti.
A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát is, a szolgáltatótól függ. 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Kényszeríti a parancsmagot, hogy olyan elemekre állítson be tulajdonságot, amelyeket egyébként nem érhet el a felhasználó. A megvalósítás szolgáltatónként eltérő. További információért lásd a about_Providerscímű részt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Csak azokat az elemeket adja meg, amelyeken a parancsmag működik, ami kizárja az összes többit. Ennek a paraméternek az értéke a 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Megadja azt az objektumot, amely a parancsmag által módosított tulajdonságokkal rendelkezik. Adjon meg egy változót, amely tartalmazza az objektumot vagy az objektumot lekérő parancsot.
Paramétertulajdonságok
| Típus: | PSObject |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
propertyPSObjectPathSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
propertyPSObjectLiteralPathSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja az elemtulajdonság elérési útját. A Path paramétertől eltérően a LiteralPath értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
propertyValueLiteralPathSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
propertyPSObjectLiteralPathSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Megadja a tulajdonság nevét.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSProperty |
Paraméterkészletek
propertyValuePathSet
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
propertyValueLiteralPathSet
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
Az elem tulajdonságát képviselő objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja a módosítani kívánt tulajdonsággal rendelkező elemek elérési útját.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
propertyValuePathSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
propertyPSObjectPathSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Value
A tulajdonság értékét adja meg.
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
propertyValuePathSet
| Position: | 2 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
propertyValueLiteralPathSet
| Position: | 2 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSObject
Ehhez a parancsmaghoz csövezhet objektumokat.
Kimenetek
None, System.Management.Automation.PSCustomObject
Ez a parancsmag létrehoz egy PSCustomObject objektumot, amely a módosított elemet és annak új tulajdonságértékét jelöli, ha megadja a PassThru paramétert. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
Set-ItemProperty úgy tervezték, 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 Get-PSProvider. További információért lásd a about_Providerscímű részt.