Powershell 自動化變量 是那些一旦打開Powershell就會自動加載的變量。
這些變量一般存放的內容包括
用戶信息:例如用戶的根目錄$home
配置信息:例如powershell控制臺的大小,顏色,背景等。
運行時信息:例如一個函數由誰調用,一個腳本運行的目錄等。
1
2
3
4
5
6
7
8
9
10
11
12
13
|
PS> $HOME C:\Users\test PS> $currentProcessID=$pid PS> $currentProcessID 5356 PS> Get-Process -Id $pid Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName ------- ------ ----- ----- ----- ------ -- ----------- 390 10 30604 33100 172 1.11 5356 powershell PS> $PROFILE C:\Users\test\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 |
powershell中的某些自動化變量只能讀,不能寫。例如:$Pid。
可以通過Get-Help about_Automatic_variables查看Automatic_variables的幫助。
TOPIC
about_Automatic_Variables
主題
about_Automatic_Variables
簡短說明
說明存儲 Windows PowerShell 狀態信息的變量。
這些變量由 Windows PowerShell 創建并維護。
詳細說明
下面是 Windows PowerShell 中的自動變量的列表:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
$$ 包含會話所收到的最后一行中的最后一個令牌。 $? 包含最后一個操作的執行狀態。如果最后一個操作成功,則包含 TRUE,失敗則包含 FALSE。 $^ 包含會話所收到的最后一行中的第一個令牌。 $_ 包含管道對象中的當前對象。在對管道中的每個對象或所選對象執行操作的命令中,可以使用此變量。 $Args 包含由未聲明參數和/或傳遞給函數、腳本或腳本塊的參數值組成的數組。 在創建函數時可以聲明參數,方法是使用 param 關鍵字或在函數名稱后添加以圓括號括起、逗號 分隔的參數列表。 $ConsoleFileName 包含在會話中最近使用的控制臺文件 (.psc1) 的路徑。在通過 PSConsoleFile 參數啟動 Windows PowerShell 或使用 Export-Console cmdlet 將管理單元名稱導出到控制臺文件 時,將填充此變量。 在使用不帶參數的 Export-Console cmdlet 時,它自動更新在會話中最近使用的控制臺文件。 可以使用此自動變量確定要更新的文件。 $Error 包含錯誤對象的數組,這些對象表示最近的一些錯誤。最近的錯誤是該數組中的第一個錯誤對象 ($Error[0])。 $Event 包含一個 PSEventArgs 對象,該對象表示一個正在被處理的事件。 此變量只在事件注冊命令(例如 Register-ObjectEvent)的 Action 塊內填充。 此變量的值是 Get-Event cmdlet 返回的同一個對象。 因此,可以在 Action 腳本塊中使用 $Event 變量的屬性(例如 $Event.TimeGenerated)。 $EventSubscriber 包含一個 PSEventSubscriber 對象,該對象表示正在被處理的事件的事件訂閱者。 此變量只在事件注冊命令的 Action 塊內填充。此變量的值 是 Get-EventSubscriber cmdlet 返回的同一個對象。 $ExecutionContext 包含一個 EngineIntrinsics 對象,該對象表示 Windows PowerShell 主機的執行上下文。 可以使用此變量來查找可用于 cmdlet 的執行對象。 $False 包含 FALSE。可以使用此變量在命令和腳本中表示 FALSE,而不是使用字符串”false”。如果 該字符串轉換為非空字符串或非零整數,則可將該字符串解釋為 TRUE。 $ForEach 包含 ForEach-Object 循環的枚舉數。可以對 $ForEach 變量的值使用枚舉數的屬性和方法。 此變量僅在運行 For 循環時存在,循環完成即會刪除。 $Home 包含用戶的主目錄的完整路徑。此變量等效于 %homedrive%%homepath% 環境變量。 $Host 包含一個對象,該對象表示 Windows PowerShell 的當前主機應用程序。可以使用此變量在命 令中表示當前主機,或者顯示或更改主機的屬性,如 $Host.version、$Host.CurrentCulture 或 $host.ui.rawui.setbackgroundcolor(“Red”)。 $Input 一個枚舉數,它包含傳遞給函數的輸入。$Input 變量區分大小寫,只能用于函數和腳本塊。(腳 本塊本質上是未命名的函數。)在函數的 Process 塊中,$Input 變量包含當前位于管道中的對 象。在 Process 塊完成后,$Input 的值為 NULL。如果函數沒有 Process 塊,則 $Input 的值可用于 End 塊,它包含函數的所有輸入。 $LastExitCode 包含運行的最后一個基于 Windows 的程序的退出代碼。 $Matches $Matches 變量與 -match 和 -not match 運算符一起使用。 將標量輸入提交給 -match 或 -notmatch 運算符時,如果檢測到匹配,則會返回一個布爾值, 并使用由所有匹配字符串值組成的哈希表填充 $Matches 自動變量。有關 -match 運算符的詳細 信息,請參閱 about_comparison_operators。 $MyInvocation 包含一個對象,該對象具有有關當前命令(如腳本、函數或腳本塊)的信息。可以使用該對象中的 信息(如腳本的路徑和文件名 ($myinvocation.mycommand.path) 或函數的名稱 ($myinvocation.mycommand.name))來標識當前命令。對于查找正在運行的腳本的名稱,這非常有用。 $NestedPromptLevel 包含當前提示級別。值 0 指示原始提示級別。該值在進入嵌套級別時遞增,在退出嵌套級別時遞減。 例如,在使用 $Host.EnterNestedPrompt 方法時,Windows PowerShell 會出現嵌套命令 提示符。在 Windows PowerShell 調試程序中到達斷點時,Windows PowerShell 也會出現嵌 套命令提示符。 在進入嵌套提示時,Windows PowerShell 暫停當前命令,保存執行上下文,并遞增 $NestedPromptLevel 變量的值。要創建更多嵌套命令提示符(最多 128 級)或返回到原始命 令提示符,請完成命令,或鍵入”exit”。 $NestedPromptLevel 變量有助于跟蹤提示級別。可以創建包含此值的備用 Windows PowerShell 命令提示符,以使此值始終可見。 $NULL 包含 NULL 或空值。可以在命令和腳本中使用此變量表示 NULL,而不是使用字符串”NULL”。 如果該字符串轉換為非空字符串或非零整數,則可將該字符串解釋為 TRUE。 $PID 包含承載當前 Windows PowerShell 會話的進程的進程標識符 (PID)。 $Profile 包含當前用戶和當前主機應用程序的 Windows PowerShell 配置文件的完整路徑。可以在命令 中使用此變量表示配置文件。例如,可以在命令中使用此變量確定是否已創建某個配置文件: test-path $profile 也可以在命令中使用此變量創建配置文件: new-item -type file -path $pshome -force 此外,還可以在命令中使用此變量在記事本中打開配置文件: notepad $profile $PSBoundParameters 包含活動參數及其當前值的字典。只有在聲明參數的作用域(如腳本或函數)中, 此變量才有值。可以使用此變量顯示或更改參數的當前值,也可以將參數值傳遞給 其他腳本或函數。 例如: function test { param($a, $b) # Display the parameters in dictionary format. $psboundparameters # Call the Test1 function with $a and $b. test1 @psboundparameters } $PsCmdlet 包含一個對象,該對象表示正在運行的 cmdlet 或高級函數。 可以在 cmdlet 或函數代碼中使用該對象的屬性和方法來響應使用的條件。例如, ParameterSetName 屬性包含正在使用的參數集的名稱,而 ShouldProcess 方法將 WhatIf 和 Confirm 參數動態添加到 cmdlet。 有關 $PSCmdlet 自動變量的詳細信息,請參閱 about_Functions_Advanced。 $PsCulture 包含操作系統中當前所用的區域性的名稱。區域性確定數字、貨幣和日期等項的顯示格式。這是系 統的 System.Globalization.CultureInfo.CurrentCulture.Name 屬性的值。要獲取系統 的 System.Globalization.CultureInfo 對象,請使用 Get-Culture cmdlet。 $PSDebugContext 在調試期間,此變量包含有關調試環境的信息。在其他時間,此變量包含 NULL 值。因此,可以使 用此變量指示調試程序是否擁有控制權。填充之后,此變量包含一個具有 Breakpoints 和 InvocationInfo 屬性的 PsDebugContext 對象。InvocationInfo 屬性有多個十分有用的 屬性,包括 Location 屬性。Location 屬性指示正在調試的腳本的路徑。 $PsHome 包含 Windows PowerShell 的安裝目錄的完整路徑(通常為 %windir%System32WindowsPowerShellv1.0)。可以在 Windows PowerShell 文件 的路徑中使用此變量。例如,下面的命令在概念性幫助主題中搜索”variable”一詞: select-string -pattern variable -path $pshome*.txt $PSScriptRoot 包含要從中執行腳本模塊的目錄。 通過此變量,腳本可以使用模塊路徑來訪問其他資源。 $PsUICulture 包含操作系統中當前所用的用戶界面 (UI) 區域性的名稱。UI 區域性確定哪些文本字符串用于用戶 界面元素(如菜單和消息)。這是系統的 System.Globalization.CultureInfo.CurrentUICulture.Name 屬性的值。要獲取系統 的 System.Globalization.CultureInfo 對象,請使用 Get-UICulture cmdlet。 $PsVersionTable 包含一個只讀哈希表,該哈希表顯示有關在當前會話中運行的 Windows PowerShell 版本的詳 細信息。 該表包括下列項: CLRVersion: 公共語言運行時 (CLR) 的版本 BuildVersion: 當前版本的內部版本號 PSVersion: Windows PowerShell 版本號 WSManStackVersion: WS-Management 堆棧的版本號 PSCompatibleVersions: 與當前版本兼容的 Windows PowerShell 版本 SerializationVersion :序列化方法的版本 PSRemotingProtocolVersion:Windows PowerShell 遠程管理協議的版本 $Pwd 包含一個路徑對象,該對象表示當前目錄的完整路徑。 $Sender 包含生成此事件的對象。此變量只在事件注冊命令的 Action 塊內填充。 此變量的值也可在 Get-Event 返回的 PSEventArgs (System.Management.Automation.PSEventArgs) 對象的 Sender 屬性中找到。 $ShellID 包含當前 shell 的標識符。 $SourceArgs 包含表示正在被處理的事件的事件參數的對象。此變量只在事件注冊命令的 Action 塊內填充。此變量的值也可在 Get-Event 返回的 PSEventArgs (System.Management.Automation.PSEventArgs) 對象的 SourceArgs 屬性中找到。 $SourceEventArgs 包含一個對象,該對象表示從正在被處理的事件的 EventArgs 中派生出的 第一個事件參數。此變量只在事件注冊命令的 Action 塊內填充。 此變量的值也可在 Get-Event 返回的 PSEventArgs (System.Management.Automation.PSEventArgs) 對象的 SourceArgs 屬性中找到。 $This 在定義腳本屬性或腳本方法的腳本塊中,$This 變量引用要擴展的對象。 $True 包含 TRUE。可以在命令和腳本中使用此變量表示 TRUE。 |
另請參閱
about_Hash_Tables
about_Preference_Va
riables
about_Variables