將目前位置加入至位置清單 (「堆疊」) 的最頂層。

語法

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 堆疊會成為目前堆疊。






請參閱




目錄