New-ItemProperty

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

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

Sözdizimi

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.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:PSCredential
Position:Named
Default value:Current user
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Diğer adlar:PSPath, LP
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

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

Tür:String
Diğer adlar:PSProperty
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Path

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

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.
Tür:String
Diğer adlar:Type
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Value

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

Tür:Object
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.