Olvasás angol nyelven

Megosztás a következőn keresztül:

New-ItemProperty

  • Referencia
Modul:
Microsoft.PowerShell.Management

Létrehoz egy új tulajdonságot 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ásjegyzék-értékek létrehozására szolgál, mivel a beállításjegyzék-é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 objektum egy példányához, használja a Add-Member parancsmagot.
  • Ha egy tulajdonságot szeretne hozzáadni egy adott típusú objektumhoz, módosítsa a Types.ps1xml fájlt.

Példák

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

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

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

A második parancs a Get-ItemProperty parancsmaggal látja 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ék-bejegyzés hozzáadása egy kulcshoz

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

A parancs első része a Get-Item parancsmaggal szerzi be a MyCompany beállításkulcsot. A folyamatüzemeltető elküldi a parancs eredményeit a New-ItemProperty, amely hozzáadja az új beállításjegyzék-bejegyzést (NoOfLocations), és annak értékét (3) a MyCompany kulcshoz.

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 a RegistryKey objektum elérési útját társítja, amelyet Get-Item a New-ItemPropertyLiteralPath paraméterével ad 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 értéket hoz létre here-string használatával.

$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 azt mutatja be, hogyan hozhat létre értéktömböt a 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

Megerősíté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

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.

Megjegyzé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 a Invoke-Command.

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 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. A Kizárás paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát 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 a 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 FileSystem szűrőnyelvének szintaxisa about_Wildcards. 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 tulajdonságot hozzon létre egy objektumon, amelyhez egyébként nem fér hozzá 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 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. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát 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éke pontosan a beíráskor használatos. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldó karaktereket, csatolja egy idézőjelbe ('). 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

-Name

Megadja az új tulajdonság nevét. Ha a tulajdonság beállításjegyzék-bejegyzés, ez a paraméter adja meg a bejegyzés 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

-Path

Megadja az elem elérési útját. A 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.

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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ű 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ömbje. 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 jelez, például REG_RESOURCE_LIST értékeket.
Típus:String
Aliasok:Type
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Value

Megadja a tulajdonság értékét. Ha a tulajdonság beállításjegyzék-bejegyzés, ez a paraméter határozza meg a bejegyzés értékét.

Típus:Object
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. 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

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PSCustomObject

Ez a parancsmag az új tulajdonságot képviselő egyéni objektumot ad vissza.

Jegyzetek

New-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ó: about_Providers.