PowerShell set-item命令

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用於更改提示功能,以便顯示在路徑之前的時間。