New-ItemProperty

Referensi

Modul:: Microsoft.PowerShell.Management

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.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	PSCredential
Position:	Named
Nilai default:	Current user
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	String[]
Alias:	PSPath, LP
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-Name

Menentukan nama untuk properti baru. Jika properti adalah entri registri, parameter ini menentukan nama entri.

Jenis:	String
Alias:	PSProperty
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-Path

Menentukan jalur item. Karakter kartubebas diizinkan. Parameter ini mengidentifikasi item tempat cmdlet ini menambahkan properti baru.

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	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 .

Jenis:	String
Alias:	Type
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Value

Menentukan nilai properti. Jika properti adalah entri registri, parameter ini menentukan nilai entri.

Jenis:	Object
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSCustomObject

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.

Bagikan melalui

New-ItemProperty

Sintaks

Deskripsi

Contoh

Contoh 1: Menambahkan entri registri

Contoh 2: Menambahkan entri registri ke kunci

Contoh 3: Membuat nilai MultiString di registri menggunakan Here-String

Contoh 4: Membuat nilai MultiString di registri menggunakan array

Parameter

-Confirm

-Credential

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Name

-Path

-PropertyType

-Value

-WhatIf

Input

Output

Catatan

Sumber Daya Tambahan:

Bagikan melalui

New-ItemProperty

Sintaks

Deskripsi

Contoh

Contoh 1: Menambahkan entri registri

Contoh 2: Menambahkan entri registri ke kunci

Contoh 3: Membuat nilai MultiString di registri menggunakan Here-String

Contoh 4: Membuat nilai MultiString di registri menggunakan array

Parameter

-Confirm

-Credential

-Exclude

-Filter

-Force

-Include

-LiteralPath

-Name

-Path

-PropertyType

-Value

-WhatIf

Input

Output

Catatan

Link Terkait

Sumber Daya Tambahan: