New-ItemProperty

Új tulajdonságot hoz létre egy elemhez, és beállítja annak értékét.

Syntax

New-ItemProperty
   [-Path] <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-ItemProperty
   -LiteralPath <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A New-ItemProperty parancsmag létrehoz egy új tulajdonságot egy adott elemhez, és beállítja annak értékét. Ez a parancsmag általában új beállításkulcsok létrehozására szolgál, mivel a beállításkulcs-értékek egy beállításkulcs-elem tulajdonságai.

Ez a parancsmag nem ad hozzá tulajdonságokat egy objektumhoz.

  • Ha tulajdonságot szeretne hozzáadni egy objektumpéldányhoz, használja a Add-Member parancsmagot.
  • Ha egy tulajdonságot egy adott típusú összes objektumhoz hozzá szeretne adni, módosítsa a Types.ps1xml fájlt.

Példák

1. példa: Beállításjegyzékbeli bejegyzés hozzáadása

Ez a parancs hozzáad egy új beállításjegyzék-bejegyzést NoOfEmployeesa MyCompanyHKLM:\Software hivekulcshoz.

Az első parancs a Path paraméter használatával adja meg a MyCompany beállításkulcs elérési útját. A Név paraméterrel adja meg a bejegyzés nevét, az Érték paraméterrel pedig annak értékét.

A második parancs a Get-ItemProperty parancsmaggal tekinti meg az új beállításjegyzék-bejegyzést.

New-ItemProperty -Path "HKLM:\Software\MyCompany" -Name "NoOfEmployees" -Value 822
Get-ItemProperty "HKLM:\Software\MyCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 822

2. példa: Beállításjegyzékbeli bejegyzés hozzáadása kulcshoz

Ez a parancs egy új beállításjegyzék-bejegyzést ad hozzá egy beállításkulcshoz. A kulcs megadásához folyamatoperátort (|) használ a kulcsnak New-ItemPropertymegfelelő objektum elküldéséhez.

A parancs első része a Get-Item parancsmagot használja a MyCompany beállításkulcs lekéréséhez. A folyamatoperátor elküldi a parancs eredményeit a kulcshozNew-ItemProperty, amely hozzáadja az új beállításjegyzékbeli bejegyzést (NoOfLocations) és annak értékét (3).MyCompany

Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3

Ez a parancs azért működik, mert a PowerShell paraméterkötési funkciója társítja a RegistryKey objektum elérési útját, amely Get-Item a LiteralPath paraméterrel New-ItemPropertytér vissza. További információ: about_Pipelines.

3. példa: MultiString-érték létrehozása a beállításjegyzékben egy Here-String

Ez a példa egy MultiString Here-String használatával hoz létre egy értéket.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'HereString' -PropertyType MultiString -Value @"
This is text which contains newlines
It can also contain "quoted" strings
"@
$newValue.multistring

This is text which contains newlines
It can also contain "quoted" strings

4. példa: MultiString-érték létrehozása a beállításjegyzékben tömb használatával

A példa bemutatja, hogyan hozhat létre értéktömböt az MultiString érték létrehozásához.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]

a

Paraméterek

-Confirm

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

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

-Credential

Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához szükséges engedéllyel. Alapértelmezés szerint 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étrehozottat. Ha felhasználónevet ad meg, a rendszer jelszót kér.

Megjegyzés

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

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

-Exclude

Sztringtömbként olyan elemet vagy elemeket ad meg, amelyeket a parancsmag kizár a műveletből. Ennek a paraméternek az értéke minősíti az Elérési út paramétert. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt. Helyettesítő karakterek használata engedélyezett. A Exclude 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 határozza meg.

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

-Filter

Egy szűrőt ad meg az Elérési út paraméter minősítéséhez. 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 szintaxisát a about_Wildcards találja. A szűrők hatékonyabbak a többi paraméternél, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat ahelyett, hogy a PowerShell a beolvasásuk után szűri az objektumokat.

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

-Force

Kényszeríti a parancsmagot, hogy olyan tulajdonságot hozzon létre egy objektumon, amelyet a felhasználó egyébként nem tud elérni. Az implementáció szolgáltatónként változik. További információ: about_Providers.

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

-Include

Sztringtömbként olyan elemet vagy elemeket ad meg, amelyeket a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke minősíti az Elérési út paramétert. Adjon meg egy elérésiút-elemet vagy mintát, például *.txt. 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\*ha a helyettesítő karakter a könyvtár tartalmát C:\Windows határozza meg.

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

-LiteralPath

Egy vagy több hely elérési útját adja meg. 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 út tartalmaz feloldókaraktereket, tegye idézőjelek közé ('). Az egyszeres idézőjelek arra utasítják a PowerShellt, hogy ne értelmezze feloldókarakterekként a karaktereket.

További információ: about_Quoting_Rules.

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

-Name

Megadja az új tulajdonság nevét. Ha a tulajdonság egy beállításjegyzékbeli bejegyzés, ez a paraméter határozza meg a bejegyzés nevét.

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

-Path

Megadja az elem elérési útját. Helyettesítő karakterek használata engedélyezett. Ez a paraméter azonosítja azt az elemet, amelyhez a parancsmag hozzáadja az új tulajdonságot.

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

-PropertyType

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ű karakterláncot ad meg. Értékek REG_SZ 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 ad meg bármilyen formában. Értékek REG_BINARY használatos.
  • DWord: 32 bites bináris számot ad meg. REG_DWORD értékekhez használatos.
  • MultiString: Null értékű, két null karakterrel végződő karakterláncokat tartalmazó tömböt ad meg. REG_MULTI_SZ értékekhez használatos.
  • Qword: 64 bites bináris számot ad meg. Értékek REG_QWORD használatos.
  • Unknown: Nem támogatott beállításjegyzék-adattípust jelöl, például REG_RESOURCE_LIST értékeket.
Type:String
Aliases:Type
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Value

A tulajdonság értékét adja meg. Ha a tulajdonság egy beállításjegyzékbeli bejegyzés, ez a paraméter határozza meg a bejegyzés értékét.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet bemenetet átirányítani.

Kimenetek

PSCustomObject

New-ItemProperty az új tulajdonságot tartalmazó egyéni objektumot ad vissza.

Jegyzetek

New-ItemProperty A úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PSProvider: . További információ: about_Providers.