Set-ItemProperty

  • Referencia
Modul:
Microsoft.PowerShell.Management

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 $TrueIsReadOnly 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-ItemPropertyvan á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.

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, 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.

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

-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.

Type:PSObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Name

Megadja a tulajdonság nevét.

Type:String
Aliases:PSProperty
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Az elem tulajdonságát képviselő objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-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.

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

-Value

A tulajdonság értékét adja meg.

Type:Object
Position:2
Default value:None
Required:True
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

PSObject

Ehhez a parancsmaghoz csövezhet objektumokat.

Kimenetek

None

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

PSCustomObject

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-ItemPropertytartalmazza:

  • 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.