Share via

New-ItemProperty

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Bir öğe için yeni bir özellik oluşturur ve değerini ayarlar.

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

Cmdlet, New-ItemProperty belirtilen bir öğe için yeni bir özellik oluşturur ve değerini ayarlar. Kayıt defteri değerleri bir kayıt defteri anahtar öğesinin özellikleri olduğundan, bu cmdlet genellikle yeni kayıt defteri değerleri oluşturmak için kullanılır.

Bu cmdlet bir nesneye özellik eklemez.

  • Bir nesnenin örneğine özellik eklemek için cmdlet'ini Add-Member kullanın.
  • Belirli bir türdeki tüm nesnelere özellik eklemek için Types.ps1xml dosyasını değiştirin.

Örnekler

Örnek 1: Kayıt defteri girdisi ekleme

Bu komut anahtarına NoOfEmployeesMyCompany yeni bir kayıt defteri girdisi HKLM:\Software hiveekler.

İlk komut, kayıt defteri anahtarının yolunu belirtmek için Path parametresini MyCompany kullanır. Girdi için bir ad belirtmek için Name parametresini ve değerini belirtmek için Value parametresini kullanır.

İkinci komut, yeni kayıt defteri girdisini Get-ItemProperty görmek için cmdlet'ini kullanır.

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

Örnek 2: Anahtara kayıt defteri girdisi ekleme

Bu komut, kayıt defteri anahtarına yeni bir kayıt defteri girdisi ekler. Anahtarı belirtmek için işlem hattı işlecini (|) kullanarak anahtarını temsil eden bir nesneyi adresine New-ItemPropertygönderir.

Komutun ilk bölümü, kayıt defteri anahtarını almak için cmdlet'ini MyCompany kullanırGet-Item. İşlem hattı işleci komutun sonuçlarını anahtarına New-ItemPropertyyeni kayıt defteri girdisini (NoOfLocations ) ve değerini ()3 ekleyen öğesine MyCompany gönderir.

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

Bu komut çalışır çünkü PowerShell'in parametre bağlama özelliği, değerinin LiteralPath parametresiyle döndüren Get-Item RegistryKey nesnesinin yolunu ilişkilendirirNew-ItemProperty. Daha fazla bilgi için bkz . about_Pipelines.

Örnek 3: Here-String kullanarak kayıt defterinde MultiString değeri oluşturma

Bu örnek, Here-String kullanarak bir MultiString değer oluşturur.

$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

Örnek 4: Bir dizi kullanarak kayıt defterinde MultiString değeri oluşturma

Örnekte, değeri oluşturmak için bir değer dizisinin nasıl kullanılacağı gösterilmektedir MultiString .

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

a

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.

veya Domain01\User01gibi User01 bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential oluşturulan gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Command kullanın.

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

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

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

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards bulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.

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

-Force

cmdlet'ini, kullanıcı tarafından başka türlü erişilemeyen bir nesnede özellik oluşturmaya zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers.

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

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

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

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak işareti (' içine alın). Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz . about_Quoting_Rules.

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

-Name

Yeni özellik için bir ad belirtir. Özellik bir kayıt defteri girdisiyse, bu parametre girdinin adını belirtir.

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

-Path

Öğenin yolunu belirtir. Joker karakterlere izin verilir. Bu parametre, bu cmdlet'in yeni özelliği eklediği öğeyi tanımlar.

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

-PropertyType

Bu cmdlet'in eklediği özellik türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • String: Null olarak sonlandırılan bir dize belirtir. REG_SZ değerler için kullanılır.
  • ExpandString: Değer alındığında genişletilen ortam değişkenlerine açıklanmamış başvurular içeren null olarak sonlandırılan bir dize belirtir. REG_EXPAND_SZ değerler için kullanılır.
  • Binary: İkili verileri herhangi bir biçimde belirtir. REG_BINARY değerler için kullanılır.
  • DWord: 32 bit ikili bir sayı belirtir. REG_DWORD değerleri için kullanılır.
  • MultiString: İki null karakterle sonlandırılan null sonlandırılmış dize dizisini belirtir. REG_MULTI_SZ değerler için kullanılır.
  • Qword: 64 bit ikili bir sayı belirtir. REG_QWORD değerleri için kullanılır.
  • Unknown: REG_RESOURCE_LIST değerleri gibi desteklenmeyen bir kayıt defteri veri türünü gösterir.
Type:String
Aliases:Type
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Value

Özellik değerini belirtir. Özelliği bir kayıt defteri girdisiyse, bu parametre girdinin değerini belirtir.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSCustomObject

Bu cmdlet, yeni özelliği temsil eden özel bir nesne döndürür.

Notlar

New-ItemProperty herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PSProvider. Daha fazla bilgi için bkz . about_Providers.