Set-Item

模組:: Microsoft.PowerShell.Management Module

將專案的值變更為命令中指定的值。

語法

Path (Default) - All providers

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

LiteralPath - All providers

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<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]
    [-UseTransaction]
    [-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]
    [-UseTransaction]
    [-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]
    [-UseTransaction]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

LiteralPath - Registry provider

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

Description

Set-Item cmdlet 會將項目的值，例如變數或登錄機碼，變更為命令中指定的值。

範例

範例 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-Item 動態參數。 Options 參數只有在您跟 Set-Item 或 Function 提供者一起使用時，才可在中使用。

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

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

備註

任何與 PowerShell 一起安裝的提供者都不支援此參數。若要模擬其他使用者，或在執行此 Cmdlet 時提升您的認證，請使用 Invoke-Command。

參數屬性

類型:	PSCredential
預設值:	Current user
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Exclude

指定要在此 Cmdlet 作業中排除的項目或多項，並以字串陣列形式表示。此參數的值對路徑參數進行限定。輸入路徑元素或模式，例如 *.txt。允許使用通配符字元。只有在命令包含項目的內容，例如時，C:\Windows\* 參數才有效，其中通配符會指定 C:\Windows 目錄的內容。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Filter

指定篩選條件，以限定 Path 參數。 FileSystem 提供者是唯一已安裝且支援使用篩選的 PowerShell 提供者。您可以在 about_Wildcards中找到 FileSystem 篩選語言的語法。篩選比其他參數更有效率，因為提供者會在 Cmdlet 取得物件時套用它們，而不是在擷取對象之後讓 PowerShell 篩選物件。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

強制 cmdlet 設定無法變更的項目，例如唯讀別名或變數。 Cmdlet 無法變更常數別名或變數。實作會因提供者而異。如需詳細資訊，請參閱 about_Providers。即使使用 Force 參數，Cmdlet 也無法覆寫安全性限制。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Include

指定此 Cmdlet 在操作中包含的一個或多個專案，這些專案是以字串陣列的形式表示。此參數的值對路徑參數進行限定。輸入路徑元素或模式，例如 "*.txt"。允許使用通配符字元。只有當命令包含項目的內容，例如時，C:\Windows\* 參數才有效，其中通配符會指定 C:\Windows 目錄的內容。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LiteralPath

指定通往一個或多個位置的路徑。 LiteralPath 的值會按原本輸入的方式使用。不會將任何字元解譯為通配符。如果路徑包含逸出字元，請以單引弧括住它。單引號會告知PowerShell不要將任何字元解譯為逸出序列。

如需詳細資訊，請參閱 about_Quoting_Rules。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	PSPath

參數集

LiteralPath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Options

這是由別名和函式提供者提供的動態參數。如需詳細資訊，請參閱 about_Alias_Provider 和 about_Function_Provider。

指定別名的 Options 屬性值。

有效值為：

None：別名沒有條件約束（預設值）
ReadOnly：可以刪除別名，但無法使用 Force 參數來變更
Constant：無法刪除或變更別名
Private：別名只能在目前的範圍內使用
AllScope：別名會自動複製到任何新建立的範圍中
Unspecified：未指定選項

參數屬性

類型:	ScopedItemOptions
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassThru

將代表專案的對象傳遞至管線。根據預設，此 Cmdlet 不會產生任何輸出。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定項目所在位置的路徑。允許使用通配符字元。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

Path

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Type

這是登錄提供者所提供的動態參數。登錄提供者和此參數僅在 Windows 上可用。

指定這個 Cmdlet 新增的屬性類型。此參數可接受的值為：

String：指定以 Null 結尾的字串。用於 REG_SZ 值。
ExpandString：指定一個以 null 結尾的字串，其中包含在擷取值時展開的環境變數的未展開引用。用於 REG_EXPAND_SZ 值。
Binary：以任何形式指定二進位數據。用於 REG_BINARY 的值。
DWord：指定 32 位二進位數。用於 REG_DWORD 值。
MultiString：指定以兩個 Null 字元結尾的 Null 終止字串陣列。用於 REG_MULTI_SZ 值。
Qword：指定 64 位二進位數。用於 REG_QWORD 值。
Unknown：表示不支援的登錄數據類型，例如 REG_RESOURCE_LIST 值。

參數屬性

類型:	RegistryValueKind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-UseTransaction

在作用中交易中包含命令。只有在交易進行中時，此參數才有效。如需詳細資訊，請參閱 about_Transactions。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	usetx

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Value

指定項目的新值。

參數屬性

類型:	Object
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

Object

您可以使用管線將代表項目新值的物件傳送至這個 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

Object

當您使用 PassThru 參數時，這個 Cmdlet 會傳回代表項目的物件。

備註

Windows PowerShell 包含下列 Set-Item的別名：

si
PowerShell FileSystem 提供者不支援 Set-Item。若要變更文件系統中的專案值，請使用 Set-Content Cmdlet。
在登錄磁碟驅動器中，HKLM: 和 HKCU:，Set-Item 變更登錄機碼之 [預設值] 值中的數據。
- 若要建立和變更登錄機碼的名稱，請使用 New-Item 和 Rename-Item Cmdlet。
- 若要變更登錄值中的名稱和數據，請使用 New-ItemProperty、Set-ItemProperty和 Rename-ItemProperty Cmdlet。
Set-Item 的設計目的是要處理任何提供者所公開的數據。若要列出工作階段中可用的提供者，請輸入 Get-PSProvider。如需詳細資訊，請參閱 about_Providers。

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-Item

語法

Path (Default) - All providers

LiteralPath - All providers

Path (Default) - Alias and Function providers

LiteralPath - Alias and Function providers

Path (Default) - Registry provider

LiteralPath - Registry provider

Description

範例

範例 1：建立別名

範例 2：變更環境變數的值

範例 3：修改您的提示函式

範例 4：設定提示函式的選項

參數

-Confirm

參數屬性

參數集

-Credential

參數屬性

參數集

-Exclude

參數屬性

參數集

-Filter

參數屬性

參數集

-Force

參數屬性

參數集

-Include

參數屬性

參數集

-LiteralPath

參數屬性

參數集

-Options

參數屬性

參數集

-PassThru

參數屬性

參數集

-Path

參數屬性

參數集

-Type

參數屬性

參數集

-UseTransaction

參數屬性

參數集

-Value

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

Object

輸出

None

Object

備註

相關連結

意見反應