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︰設定變數,並取得其值
這些命令會將變數的值 $desc
設定為 A description
,然後取得變數的值。
Set-Variable -Name "desc" -Value "A description"
Get-Variable -Name "desc"
Name Value
---- -----
desc A description
範例 2︰設定全域、唯讀變數
此範例會建立全域只讀變數,其中包含系統上的所有進程,然後顯示變數的所有屬性。
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。 它會使用 的 Property 參數 Format-List
搭配所有 (*
) 的值來顯示新建立變數的所有屬性。
值 (Get-Process)
會以括弧括住,以確保在儲存在變數之前執行。 否則,變數會包含 「Get-Process」 這個字。
範例 3︰了解公用與私用變數
這個範例示範如何將變數的可見性變更為 Private
。 此變數可以由有必要權限的指令碼讀取和變更,但使用者看不到此變數。
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
允許您建立與現有唯讀變數同名的變數,或變更唯讀變數的值。
根據預設,您可以覆寫變數,除非變數具有 或Constant
的選項值ReadOnly
。 如需詳細資訊,請參閱 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
:變數會複製到任何已建立的新範圍。
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:變數是可見的。 ("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 不會產生任何輸出。