PowerShell Set-Item
將專案的值更改為命令中指定的值。 它更改變數或註冊表項的值。 Windows PowerShell檔系統提供程式不支持此cmdlet。 在註冊表驅動器中,例如HKLM:
和HKCU:
它會更改註冊表項默認值中的數據。
語法
語法1
Set-Item
[-Path<String[]>]
[-Force]
[-PassThru]
[-Filter <String[]>]
[-Value<Object>]
[-Exclude <String[]>]
[-Include <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
語法2
Set-Item
[[-Value] <Object>]
[-LiteralPath <string[]>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
參數
-Path-Path
參數用於指定專案位置的路徑,接受通配符。
-LiteralPath
-LiteralPath
參數用於指定一個或多個位置的路徑。 此參數的值與鍵入時完全一樣。 如果路徑包含轉義字元,則將其用引號引起來。 沒有字元被解釋為通配符。單引號告訴Windows PowerShell,它不應將任何字元解釋為轉義序列。
-Force-Force
參數允許cmdlet設置無法更改的專案,例如變數或只讀別名。 即使使用-Force
參數,Set-Item
也無法覆蓋安全許可權。
-PassThru
-PassThru
參數用於將表示專案的對象傳遞到管道。 默認情況下,set-item
不會生成任何輸出。
-Filter-Filter
參數指定用於限定-Path
參數的篩檢程式。 FileSystem提供程式是唯一支持使用篩檢程式的PowerShell提供程式。 此參數效率更高,因為提供程式在cmdlet獲取對象時應用篩選器,而不是在訪問對象後讓Powershell篩選對象。
-Value
-Value
參數用於為專案指定新值。
-Exclude
此cmdlet在操作中排除的專案指定為字串數組。-Exclude
參數的值限定-Path
參數。 輸入模式或路徑元素,例如*.txt
。 接受通配符。 僅當cmdlet包含專案的內容(例如C:\*
,通配符*
用於指定C:
目錄的內容)時,-Exclude
參數才有效。
-Include
此cmdlet包括在操作中的專案被指定為字串數組。 -Include
參數的值限定-Path
參數。 輸入模式或路徑元素,例如*.txt
。 允許使用通配符。 僅當cmdlet包含專案的內容(例如C:\*
)時,此命令才有效。通配符*
用於指定C:
目錄的內容。
-WhatIf
-WhatIf
參數用於顯示如果執行cmdlet將發生的情況。 該cmdlet並沒有運行。
-Confirm
-Confirm
參數在運行cmdlet之前提示確認。
示例
示例1: 創建別名
此示例中的cmdlet用於為記事本創建別名。
示例2: 修改提示功能
PS C:\Users\maxsu> set-item -path function:prompt -value {'MyPS' + $(get-date -format t) + " " + $(get-location) + '>> '}
MyPS22:11 C:\Users\maxsu>>
MyPS22:11 C:\Users\maxsu>>
此示例中的cmdlet用於更改提示功能,以便顯示在路徑之前的時間。