將目前位置加入至位置清單 (「堆疊」) 的最頂層。
語法
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
描述
Push-Location Cmdlet 會將目前位置加入至 (「推入」) 位置清單 (即「堆疊」) 的最頂層。您可以將目前位置推入到預設堆疊或是所建立的堆疊上。若有指定路徑，Push-Location 會將目前位置推入堆疊，然後將目前位置切換成路徑所指定的位置。除非是目前位置，否則位置不能推入到堆疊。
參數
-LiteralPath <string>
指定新位置的路徑。LiteralPath 參數的值會取用實際輸入的內容做為參數值，與 Path 參數不同。任何字元均不被解譯成萬用字元。如果路徑中包含逸出字元，請將其置於單引號內。單引號係告訴 Windows PowerShell 不要將任何字元解譯成逸出序列。
|
必要? |
false |
|
位置? |
1 |
|
預設值 |
|
|
接受管線輸入? |
true (ByPropertyName) |
|
接受萬用字元? |
false |
-PassThru
會將代表位置的物件傳遞給管線。根據預設，此 Cmdlet 不會產生任何輸出。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
-Path <string>
將目前位置加入 (推入) 堆疊最上方之後，切換到此路徑所指定的位置。請輸入其提供者支援此 cmdlet 的位置路徑。允許使用萬用字元。參數名稱 ("Path") 為選擇項。
|
必要? |
false |
|
位置? |
1 |
|
預設值 |
|
|
接受管線輸入? |
true (ByValue, ByPropertyName) |
|
接受萬用字元? |
false |
-StackName <string>
指定堆疊的名稱。目前位置會推入此堆疊，而此堆疊則成為目前堆疊。如果堆疊不存在，會建立堆疊。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
true (ByPropertyName) |
|
接受萬用字元? |
false |
-UseTransaction
將命令加入現用交易中。此參數只有當交易進行中時才有效。如需詳細資訊，請參閱 about_Transactions。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
|
輸入 |
System.String 您可經由管道將包含路徑 (但不是常值路徑) 的字串輸出至 Push-Location。 |
|
輸出 |
None 或 System.Management.Automation.PathInfo 當您使用 PassThru 參數時，Push-Location 會產生代表位置的 System.Management.Automation.PathInfo 物件，否則，這個 Cmdlet 不會產生任何輸出。 |
附註
您也可以利用內建的別名 "pushd" 來參照 Push-Location。如需詳細資訊，請參閱 about_Aliases。
「堆疊」屬於「後進先出」(LIFO) 資料結構，如同一份垂直的清單，在其中只能夠存取最頂層的項目。您只能夠將項目加入至 (「推入」) 堆疊頂層，而且只能夠擷取 (「推出」) 堆疊頂層的項目。若要取得位於堆疊頂層下方的項目，必須先擷取該項目上方的所有項目。
Push-Location Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PSProvider"。如需詳細資訊，請參閱 about_Providers。
範例 1
C:\PS>push-location C:\Windows 描述 ----------- 這個命令會將目前位置推入預設的堆疊，然後將位置切換成 C:\Windows。
範例 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction 描述 ----------- 這個命令會將目前位置推入到 RegFunction 堆疊，然後將目前位置切換成 HKLM:\Software\Policies 位置。這個命令顯示您可以搭配 Windows PowerShell 登錄提供者使用 Push-Location。
範例 3
C:\PS>push-location 描述 ----------- 這個命令會將目前位置推入到預設的堆疊。
範例 4
C:\PS>push-location ~ -stackname Stack2 描述 ----------- 這個命令會將目前位置推入到名為 Stack2 的新堆疊，然後將目前位置切換成主目錄 (%USERPROFILE%)，在此命令中是以波狀符號 (~) 或 $home 代表主目錄。然後 Stack2 堆疊會成為目前堆疊。
請參閱