Set-ItemProperty
Egy elem tulajdonságának értékét hozza létre vagy módosítja.
Syntax
Set-ItemProperty
[-Path] <string[]>
[-Name] <string>
[-Value] <Object>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-ItemProperty
[-Path] <string[]>
-InputObject <psobject>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-ItemProperty
[-Name] <string>
[-Value] <Object>
-LiteralPath <string[]>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-ItemProperty
-LiteralPath <string[]>
-InputObject <psobject>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-ItemProperty
[-Path] <string[]>
[-Name] <string>
[-Value] <Object>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-ItemProperty
[-Path] <string[]>
-InputObject <psobject>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-ItemProperty
[-Name] <string>
[-Value] <Object>
-LiteralPath <string[]>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-ItemProperty
-LiteralPath <string[]>
-InputObject <psobject>
[-PassThru]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<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.
Például Set-ItemProperty
beállíthatja egy fájlobjektum $True
IsReadOnly tulajdonságának értékét.
A beállításjegyzék értékeinek és adatainak létrehozására és módosítására is használható Set-ItemProperty
.
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. Az Elérési út használatával adja meg a fájlt, a Név a tulajdonság nevét, az Érték paramétert pedig az új érték megadásához.
A fájl egy System.IO.FileInfo objektum, az IsReadOnly pedig csak az egyik tulajdonsága.
Az összes tulajdonság megtekintéséhez írja be a következőt 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ó: about_Automatic_Variables.
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 Set-ItemProperty
létre új beállításjegyzék-bejegyzést, és hogyan rendelhet hozzá értéket a bejegyzéshez. Létrehozza a "NoOfEmployees" bejegyzést a "ContosoCompany" kulcsban HKLM\Software
, é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, beállításjegyzék-bejegyzéseket Set-ItemProperty
hozhat létre, és értékeket hozhat létre és módosíthat.
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
Az első parancs létrehozza a beállításjegyzék-bejegyzést.
A Path használatával adja meg a meghajtó és a HKLM:
Software\MyCompany
kulcs elérési útját.
A parancs a Név paranccsal adja meg a bejegyzés nevét és az Értéket egy érték megadásához.
A második parancs a Get-ItemProperty
parancsmaggal látja az új beállításjegyzék-bejegyzést.
Ha a Get-Item
parancsmagokat használja Get-ChildItem
, 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.
A parancsmaggal létrehozhatja a New-ItemProperty
beállításjegyzék-bejegyzést és annak értékét, majd Set-ItemProperty
módosíthatja az értéket.
A meghajtóval kapcsolatos további információkért írja be a HKLM:
következőt Get-Help Get-PSDrive
: .
A beállításjegyzék kezeléséhez a PowerShell használatával kapcsolatos további információkért írja be a következőt Get-Help Registry
: .
3. példa: Elem módosítása a folyamat használatával
A példa a fájl lekérésére weekly.txt
használGet-ChildItem
. A fájlobjektum a következőre Set-ItemProperty
van állítva: . A Set-ItemProperty
parancs a Név és érték paraméterekkel adja meg a tulajdonságot és annak új értékét.
Get-ChildItem weekly.txt | Set-ItemProperty -Name IsReadOnly -Value $True
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, 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ó: about_Providers.
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 |
-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.
Típus: | PSObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-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 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a tulajdonság nevét.
Típus: | String |
Aliasok: | PSProperty |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-PassThru
Az elem tulajdonságát képviselő objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Path
Megadja a módosítani kívánt tulajdonsággal rendelkező elemek 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 |
-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.
Típus: | SwitchParameter |
Aliasok: | usetx |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Value
A tulajdonság értékét adja meg.
Típus: | Object |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | True |
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
Ehhez a parancsmaghoz csövezhet objektumokat.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A PassThru paraméter használatakor ez a parancsmag egy PSCustomObject objektumot ad vissza, amely a módosított elemet és annak új tulajdonságértékét jelöli.
Jegyzetek
A Windows PowerShell a következő aliasokat Set-ItemProperty
tartalmazza:
sp
Set-ItemProperty
ú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.