New-ItemProperty
Membuat properti baru untuk item dan menetapkan nilainya.
Sintaks
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>]
Deskripsi
New-ItemProperty
Cmdlet membuat properti baru untuk item tertentu dan menetapkan nilainya.
Biasanya, cmdlet ini digunakan untuk membuat nilai registri baru, karena nilai registri adalah properti item kunci registri.
Cmdlet ini tidak menambahkan properti ke objek.
- Untuk menambahkan properti ke instans objek, gunakan
Add-Member
cmdlet . - Untuk menambahkan properti ke semua objek dari jenis tertentu, ubah file Type.ps1xml.
Contoh
Contoh 1: Menambahkan entri registri
Perintah ini menambahkan entri registri baru, NoOfEmployees
, ke MyCompany
kunci HKLM:\Software hive
.
Perintah pertama menggunakan parameter Jalur untuk menentukan jalur MyCompany
kunci registri.
Ini menggunakan parameter Nama untuk menentukan nama untuk entri dan parameter Nilai untuk menentukan nilainya.
Perintah kedua menggunakan cmdlet untuk melihat entri registri Get-ItemProperty
baru.
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
Contoh 2: Menambahkan entri registri ke kunci
Perintah ini menambahkan entri registri baru ke kunci registri. Untuk menentukan kunci, ia menggunakan operator alur (|
) untuk mengirim objek yang mewakili kunci ke New-ItemProperty
.
Bagian pertama dari perintah menggunakan cmdlet untuk mendapatkan MyCompany
kunci registriGet-Item
. Operator alur mengirimkan hasil perintah ke New-ItemProperty
, yang menambahkan entri registri baru (NoOfLocations
), dan nilainya (3
), ke MyCompany
kunci.
Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3
Perintah ini berfungsi karena fitur pengikatan parameter PowerShell mengaitkan jalur objek RegistryKey yang Get-Item
kembali dengan parameter LiteralPath dari New-ItemProperty
. Untuk informasi selengkapnya, lihat about_Pipelines.
Contoh 3: Membuat nilai MultiString di registri menggunakan Here-String
Contoh ini membuat MultiString
nilai menggunakan Here-String.
$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
Contoh 4: Membuat nilai MultiString di registri menggunakan array
Contoh menunjukkan cara menggunakan array nilai untuk membuat MultiString
nilai.
$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]
a
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini.
Ketik nama pengguna, seperti User01
atau Domain01\User01
, atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential
cmdlet. Jika Anda mengetik nama pengguna, Anda akan dimintai kata sandi.
Catatan
Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Menentukan, sebagai array string, item atau item yang dikecualikan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt
. Karakter kartubebas diizinkan. Parameter Kecualikan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*
, di mana karakter kartubebas C:\Windows
menentukan konten direktori.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Menentukan filter untuk memenuhi syarat parameter Jalur . Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung penggunaan filter. Anda dapat menemukan sintaks untuk bahasa filter FileSystem dalam about_Wildcards. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya ketika cmdlet mendapatkan objek daripada memfilter PowerShell objek setelah diambil.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Memaksa cmdlet untuk membuat properti pada objek yang tidak dapat diakses oleh pengguna. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat about_Providers.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Menentukan, sebagai array string, item atau item yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt
. Karakter kartubebas diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*
, di mana karakter kartubebas C:\Windows
menentukan konten direktori.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal ('
). Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Untuk informasi selengkapnya, lihat about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Menentukan nama untuk properti baru. Jika properti adalah entri registri, parameter ini menentukan nama entri.
Type: | String |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Menentukan jalur item. Karakter kartubebas diizinkan. Parameter ini mengidentifikasi item tempat cmdlet ini menambahkan properti baru.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-PropertyType
Menentukan tipe properti yang ditambahkan cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah:
String
: Menentukan string yang dihentikan null. Digunakan untuk nilai REG_SZ .ExpandString
: Menentukan string yang dihentikan null yang berisi referensi yang tidak tersedia ke variabel lingkungan yang diperluas saat nilai diambil. Digunakan untuk nilai REG_EXPAND_SZ .Binary
: Menentukan data biner dalam bentuk apa pun. Digunakan untuk nilai REG_BINARY .DWord
: Menentukan angka biner 32-bit. Digunakan untuk nilai REG_DWORD .MultiString
: Menentukan array string null-terminated yang dihentikan oleh dua karakter null. Digunakan untuk nilai REG_MULTI_SZ .Qword
: Menentukan angka biner 64-bit. Digunakan untuk nilai REG_QWORD .Unknown
: Menunjukkan jenis data registri yang tidak didukung, seperti nilai REG_RESOURCE_LIST .
Type: | String |
Aliases: | Type |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Menentukan nilai properti. Jika properti adalah entri registri, parameter ini menentukan nilai entri.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
Cmdlet ini mengembalikan objek kustom yang mewakili properti baru.
Catatan
New-ItemProperty
dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketik Get-PSProvider
. Untuk informasi selengkapnya, lihat about_Providers.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk