Bagikan melalui

Set-Item

Modul:
Microsoft.PowerShell.Management Module

Mengubah nilai item menjadi nilai yang ditentukan dalam perintah.

Sintaks

Path (Default) - All providers 

Set-Item
    [-Path] <String[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers 

Set-Item
    [[-Value] <Object>]
    -LiteralPath <String[]>
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Path (Default) - Alias and Function providers 

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

LiteralPath - Alias and Function providers 

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

Path (Default) - Registry provider 

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

LiteralPath - Registry provider 

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

Deskripsi

cmdlet Set-Item mengubah nilai item, seperti variabel atau kunci registri, ke nilai yang ditentukan dalam perintah.

Contoh

Contoh 1: Membuat alias

Perintah ini membuat alias np untuk Notepad.

Set-Item -Path Alias:np -Value "C:\windows\notepad.exe"

Contoh 2: Mengubah nilai variabel lingkungan

Perintah ini mengubah nilai variabel lingkungan UserRole menjadi Administrator.

Set-Item -Path Env:UserRole -Value "Administrator"

Contoh 3: Ubah fungsi prompt Anda

Perintah ini mengubah fungsi prompt sehingga menampilkan waktu sebelum jalur.

Set-Item -Path Function:prompt -Value {
    'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '
}

Contoh 4: Atur opsi untuk fungsi prompt Anda

Perintah ini mengatur opsi AllScope dan ReadOnly untuk fungsi prompt. Perintah ini menggunakan parameter dinamis Options dari Set-Item. Parameter Opsi tersedia di Set-Item hanya ketika Anda menggunakannya dengan Alias atau penyedia Fungsi.

Set-Item -Path Function:prompt -Options "AllScope,ReadOnly"

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Credential

Nota

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.

Properti parameter

Jenis:PSCredential
Nilai default:Current user
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Exclude

Menentukan item atau item-item yang tidak akan disertakan dalam operasi oleh cmdlet ini, dalam bentuk array string. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter pengganti diizinkan. Parameter Exclude hanya efektif ketika perintah menyertakan konten suatu item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Filter

Menentukan filter untuk mengkualifikasi 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 saat cmdlet mendapatkan objek, bukan PowerShell yang memfilternya setelah objek tersebut diambil.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Memaksa cmdlet untuk mengatur item yang tidak dapat diubah, seperti alias atau variabel baca-saja. Cmdlet tidak dapat mengubah alias atau variabel konstanta. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat tentang_Penyedia. Bahkan dengan menggunakan parameter Force, cmdlet tidak dapat mengatasi pembatasan keamanan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Include

Menentukan item atau beberapa item dalam bentuk array string yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti "*.txt". Karakter pengganti diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-LiteralPath

Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang diketikkan. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika jalur menyertakan karakter escape, bungkus jalur tersebut dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Untuk informasi lebih lanjut, lihat about_Quoting_Rules.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath, LP

Set parameter

LiteralPath
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Options

Ini adalah parameter dinamis yang disediakan oleh penyedia Alias dan Fungsi . Untuk informasi selengkapnya, lihat about_Alias_Provider dan about_Function_Provider.

Menentukan nilai properti Opsi dari sebuah alias.

Nilai yang valid adalah:

  • None: Alias tidak memiliki batasan (nilai default)
  • ReadOnly: Alias dapat dihapus tetapi tidak dapat diubah tanpa menggunakan parameter Force
  • Constant: Alias tidak dapat dihapus atau diubah
  • Private: Alias hanya tersedia dalam cakupan saat ini
  • AllScope: Alias disalin ke semua cakupan baru yang dibuat
  • Unspecified: Opsi tidak ditentukan

Properti parameter

Jenis:ScopedItemOptions
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PassThru

Meneruskan objek yang mewakili item ke rantai pemrosesan. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Path

Menentukan jalur lokasi item. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

Path
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Type

Ini adalah parameter dinamis yang disediakan oleh penyedia Registri . Penyedia Registri dan parameter ini hanya tersedia di Windows.

Menentukan tipe properti yang ditambahkan cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah:

  • String: Menentukan string yang diakhiri dengan null. Digunakan untuk nilai REG_SZ.
  • ExpandString: Menentukan string yang diakhiri dengan null yang memuat referensi yang tidak diperluas ke variabel lingkungan yang diperluas ketika 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 berisi string yang diakhiri dengan null, yang diakhiri 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.

Properti parameter

Jenis:RegistryValueKind
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Value

Menentukan nilai baru untuk item tersebut.

Properti parameter

Jenis:Object
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:1
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

Object

Anda dapat menyalurkan objek yang mewakili nilai baru item ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

Object

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek yang mewakili item.

Catatan

PowerShell menyertakan alias berikut untuk Set-Item:

  • Semua platform:

    • si

  • Set-Item tidak didukung oleh penyedia PowerShell FileSystem. Untuk mengubah nilai item dalam sistem file, gunakan cmdlet Set-Content.

  • Di drive Registri, HKLM: dan HKCU:, Set-Item mengubah data dalam nilai (Default) kunci registri.

    • Untuk membuat dan mengubah nama kunci registri, gunakan cmdlet New-Item dan Rename-Item.
    • Untuk mengubah nama dan data dalam nilai registri, gunakan cmdlet New-ItemProperty, Set-ItemProperty, dan Rename-ItemProperty.

  • Set-Item dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.