Set-Variable
設定變數的值。 如果要求的名稱的變數不存在，便會建立變數。
Syntax
Set-Variable
[-Name] <String[]>
[[-Value] <Object>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Description <String>]
[-Option <ScopedItemOptions>]
[-Force]
[-Visibility <SessionStateEntryVisibility>]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Set-Variable Cmdlet 會將值指派給指定的變數，或變更目前的值。 如果變數不存在，Cmdlet 就會建立變數。
範例
範例 1︰設定變數，並取得其值
PS C:\> Set-Variable -Name "desc" -Value "A description"
PS C:\> Get-Variable -Name "desc"這些命令會將 desc 變數的值設定為 A description，然後取得變數的值。
範例 2︰設定全域、唯讀變數
PS C:\> Set-Variable -Name "processes" -Value (Get-Process) -Option constant -Scope global -Description "All processes" -PassThru | Format-List -Property *此命令建立包含系統上所有處理程序的全域、唯讀變數，然後顯示該變數的所有屬性。
命令使用 Set-Variable Cmdlet 建立變數。 它使用 PassThru 參數建立代表新變數的物件，並使用管線運算子 (|) 將物件傳遞至 Format-list Cmdlet 。 它使用 Format-List 的 Property 參數與全部 (*) 的值，顯示新建立之變數的所有屬性。
"(Get-Process)" 值是括在括號內，以確保它在執行之後才儲存在變數中。 否則變數包含會 "Get-Process" 字詞。
範例 3︰了解公用與私用變數
PS C:\> New-Variable -Name "counter" -Visibility Public -Value 26
PS C:\> $Counter
26
PS C:\> Get-Variable c*
Name Value
---- -----
Culture en-US
ConsoleFileName
ConfirmPreference High
CommandLineParameters {}
Counter 26
PS C:\> Set-Variable -Name "counter" -Visibility Private
PS C:\> Get-Variable c*
Name Value
---- -----
Culture en-US
ConsoleFileName
ConfirmPreference High
CommandLineParameters {}
PS C:\> $counter
"Cannot access the variable '$counter' because it is a private variable"
PS C:\> .\use-counter.ps1
#Commands completed successfully.此命令會顯示如何將變數的可見性變更為「私用」。 此變數可以由有必要權限的指令碼讀取和變更，但使用者看不到此變數。
範例輸出顯示公用和私用變數的行為差異。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定變數的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exclude
指定此 Cmdlet 從作業排除之項目的陣列。
此參數的值會限定 Path 參數。
輸入路徑元素或模式，例如 *.txt。
允許使用萬用字元。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
允許您建立與現有唯讀變數同名的變數，或變更唯讀變數的值。
根據預設，您可以覆寫變數，除非該變數具有 ReadOnly 或 Constant 的選項值。 如需詳細資訊，請參閱 Option 參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
指定此 Cmdlet 在作業中納入之項目的陣列。
此參數的值會限定 Name 參數。
輸入名稱或名稱模式，例如 c*。
允許使用萬用字元。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Name
指定變數名稱。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Option
指定變數的 Options 屬性值。
有效值為：
- None：不設定任何選項。 ("None" 為預設值。)
- ReadOnly：可以刪除。 無法變更，除非使用 Force 參數。
- Constant：不能刪除或變更。 "Constant" 只在您建立變數時有效。 您不能將現有變數的選項變更為 "Constant"。
- Private：變數只能在目前的範圍中使用。
- AllScope：將變數複製到任何新建立的範圍。
若要查看工作階段中所有變數的 Options 屬性，請輸入 Get-Variable | Format-Table -Property name, options -Autosize。
| Type: | ScopedItemOptions |
| Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
傳回代表新變數的物件。 根據預設，此 Cmdlet 不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
指定變數的範圍。此參數可接受的值為：
- 全球
- 本機
- 指令碼
- 私人
- 相對於目前範圍的數字 (0 至範圍數目，0 為目前範圍，1 為其父系)。
Local 為預設值。
如需詳細資訊，請參閱 about_Scopes。
| Type: | String |
| Position: | Named |
| Default value: | Local |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
指定變數的值。
| Type: | Object |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Visibility
決定是否可在變數建立所在的工作階段之外看見變數。 此參數是針對將傳遞給其他使用者的指令碼和命令中使用所設計。
有效值為：
- 公用：變數是可見的。 ("Public" 為預設值。)
- Private：看不到變數。
當變數為私用變數時，它不會顯示在變數清單中 (例如由 Get-Variable 傳回的清單) 或顯示在 Variable: 磁碟機的顯示畫面中。 讀取或變更私用變數值的命令會傳回錯誤。 但是，如果命令是寫入在定義變數的工作階段中，使用者就可以執行使用私用變數的命令。
| Type: | SessionStateEntryVisibility |
| Accepted values: | Public, Private |
| Position: | Named |
| Default value: | Public |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
輸入
您可以使用管線將代表變數值的物件傳送至 Set-Variable。
輸出
None or System.Management.Automation.PSVariable
使用 PassThru 參數時，Set-Variable 會產生代表新變數或已變更變數的 System.Management.Automation.PSVariable 物件。 否則，此 Cmdlet 不會產生任何輸出。