New-ItemProperty
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]
[-UseTransaction]
[<CommonParameters>] New-ItemProperty
-LiteralPath <String[]>
[-Name] <String>
[-PropertyType <String>]
[-Value <Object>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<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-Memberkullanı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 3Bu komut çalışır çünkü Windows 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]
aParametreler
-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şlemden hariç tutulduğu bir özellik veya özelliği belirtir.
Bu parametrenin değeri Path parametresini niteler.
gibi *.txtbir yol öğesi veya deseni girin.
Joker karakterlere izin verilir.
| Tür: | String[] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Filter
Sağlayıcının biçiminde veya dilinde bir filtre belirtir. Bu parametrenin değeri Path parametresini niteler.
Joker karakterlerin kullanımı da dahil olmak üzere filtrenin söz dizimi sağlayıcıya bağlıdır. 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: | False |
-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: | False |
-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 |
| 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. 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: | False |
-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 |
-UseTransaction
Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz . about_Transactions.
| Tür: | SwitchParameter |
| Diğer adlar: | usetx |
| Position: | Named |
| Default value: | False |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| 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
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.
İlişkili Bağlantılar
PowerShell