Set-Item
將項目的值變更為命令中指定的值。
Syntax
Set-Item
[-Path] <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-Item
-LiteralPath <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Cmdlet 會將 Set-Item 專案的值變更為命令中指定的值，例如變數或登錄機碼。
範例
範例 1：建立別名
此命令會為 [記事本] 建立 np 的別名。
Set-Item -Path alias:np -Value "c:\windows\notepad.exe"範例 2：變更環境變數的值
此命令會將 UserRole 環境變數的值變更為 Administrator。
Set-Item -Path env:UserRole -Value "Administrator"範例 3：修改提示函式
此命令會變更提示函式，使其顯示在路徑之前的時間。
Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}範例 4：設定提示函式的選項
此命令會設定提示函式的 AllScope 和 ReadOnly 選項。
此命令使用 的 Set-ItemOptions動態參數。
只有在您搭配別名或函式提供者使用它時，才能使用 Options參數 Set-Item 。
Set-Item -Path function:prompt -Options "AllScope,ReadOnly"參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
注意
任何隨 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者，或在執行此 Cmdlet 時提高您的認證，請使用 Invoke-Command。
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Exclude
指定此 Cmdlet 在作業中排除的專案或專案，做為字串陣列。 此參數的值會限定 Path 參數。 輸入路徑元素或模式，例如 *.txt。 允許使用萬用字元。 Exclude 參數只有在 命令包含專案的內容時有效，例如 C:\Windows\* ，其中萬用字元會指定目錄的內容 C:\Windows 。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
指定篩選準則以限定 Path 參數。 FileSystem提供者是唯一支援使用篩選的已安裝 PowerShell 提供者。 您可以在about_Wildcards中找到FileSystem篩選語言的語法。 篩選比其他參數更有效率，因為提供者會在 Cmdlet 取得物件時套用它們，而不是在擷取物件之後讓 PowerShell 篩選物件。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
強制 Cmdlet 設定無法變更的專案，例如唯讀別名或變數。 此 Cmdlet 無法變更常數別名或變數。 實作會依提供者而異。 如需詳細資訊，請參閱 about_Providers。 即使使用 Force 參數，Cmdlet 也無法覆寫安全性限制。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
以字串陣列指定此 Cmdlet 在作業中納入的項目。 此參數的值會限定 Path 參數。 輸入路徑元素或模式，例如 "*.txt"。 允許使用萬用字元。 Include參數只有在命令包含專案的內容時有效，例如 C:\Windows\* ，其中萬用字元會指定目錄的內容 C:\Windows 。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-LiteralPath
指定一個或多個位置的路徑。 LiteralPath的值會完全依照其類型使用。 沒有字元會被視為萬用字元。 如果路徑包含逸出字元，請將它括在單引號中。 單引號會告訴 PowerShell 不要將任何字元解譯為逸出序列。
如需詳細資訊，請參閱 about_Quoting_Rules。
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
將代表專案的物件傳遞至管線。 根據預設，此 Cmdlet 不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定專案位置的路徑。 允許使用萬用字元。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Value
指定項目的新值。
| Type: | Object |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
您可以使用管線將代表專案新值的物件傳送至這個 Cmdlet。
輸出
None or an object representing the new or changed item.
如果您指定 PassThru 參數，此 Cmdlet 會產生代表專案的物件。 否則，此 Cmdlet 不會產生任何輸出。
備註
Set-ItemPowerShell FileSystem 提供者不支援。 若要變更檔案系統中的專案值，請使用Set-ContentCmdlet。- 在登錄磁片磁碟機
HKLM:和HKCU:中，Set-Item變更登錄機碼 (預設) 值中的資料。- 若要建立和變更登錄機碼的名稱，請使用
New-Item和Rename-ItemCmdlet。 - 若要變更登錄值中的名稱和資料，請使用
New-ItemProperty、Set-ItemProperty和Rename-ItemPropertyCmdlet。
- 若要建立和變更登錄機碼的名稱，請使用
Set-Item是設計來使用任何提供者所公開的資料。 若要列出工作階段中可用的提供者，請輸入Get-PsProvider。 如需詳細資訊，請參閱 about_Providers。