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 MyCompany kulcsához HKLM:\Software hive.

Az első parancs az Elérési út 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étert pedig annak értékének megadásához.

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ővel (|) küld egy objektumot, amely a kulcsot New-ItemPropertyjelöli.

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 kulcshozNew-ItemProperty, amely hozzáadja az új beállításjegyzék-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 LiterálPath paraméterrel New-ItemPropertyad vissza. További információ: about_Pipelines.

3. példa: MultiString-érték létrehozása a beállításjegyzékben here-string használatával

Ez a példa egy MultiString Here-String használatával hoz létre é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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint az aktuális felhasználó.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01írjon be egy PSCredential objektumot, például a parancsmag által Get-Credential létrehozott objektumot. Ha felhasználónevet ír be, a rendszer jelszót kér.

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

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

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

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Aliases:PSProperty
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
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ű 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:String
Aliases:Type
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

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