Push-Location

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Push-Location コマンドレットは、現在の場所を場所スタックに追加 ("プッシュ") します。 パスを指定した場合、Push-Location は現在の場所を場所スタックにプッシュし、現在の場所をパスで指定された場所に変更します。 Pop-Location コマンドレットを使用して、場所スタックから場所を取得できます。

既定では、 Push-Location コマンドレットは現在の場所を現在の場所スタックにプッシュしますが、StackName パラメーターを使用して別の場所スタックを指定できます。 スタックが存在しない場合は、Push-Location 作成します。

場所スタックの詳細については、「メモ」を参照してください。

次の使用例は、現在の場所を既定の場所スタックにプッシュし、場所を C:\Windowsに変更します。

PS C:\> Push-Location C:\Windows

次の使用例は、現在の場所を RegFunction スタックにプッシュし、現在の場所を HKLM:\Software\Policies の場所に変更します。

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

任意の PowerShell ドライブ (PSDrive) で Location コマンドレットを使用できます。

このコマンドは、現在の場所を既定のスタックにプッシュします。 場所は変更されません。

PS C:\> Push-Location

これらのコマンドは、名前付き場所スタックを作成して使用する方法を示しています。

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

最初のコマンドは、現在の場所を Stack2 という名前の新しいスタックにプッシュし、次に現在の場所をホーム ディレクトリに変更します。ホーム ディレクトリは、コマンド内でチルダ記号 (~) で表されます ( $env:USERPROFILE や $HOME と同じ)。

セッションに Stack2 がまだ存在しない場合は、Push-Location 作成されます。 2 番目のコマンドでは、 Pop-Location コマンドレットを使用して、Stack2 スタックから元の場所 (PS C:\>) をポップします。 StackName パラメーターを指定しない場合、 Pop-Location は名前のない既定のスタックから場所をポップします。

ロケーション スタックの詳細については、Notesを参照してください。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

パス (リテラル パスではない) を含む文字列を Push-Location にパイプ処理できます。

PassThru パラメーターを使用すると、 Push-Location は場所を表す System.Management.Automation.PathInfo オブジェクトを生成します。 それ以外の場合、このコマンドレットは出力を生成しません。

「スタック」は、最後に追加されたアイテムのみにアクセスできる後入れ先出しのリストです。 アイテムを使用する順序でスタックに追加し、逆の順序で使用するためにアイテムを取得します。 PowerShell を使用すると、プロバイダーの場所を場所スタックに格納できます。

PowerShell では、名前のない既定の場所スタックが作成され、複数の名前付き場所スタックを作成できます。 スタック名を指定しない場合、Windows PowerShell は現在の場所のスタックを使用します。 既定では、名前のない既定の場所は現在の場所スタックですが、Set-Location コマンドレットを使用して現在の場所スタックを変更できます。

場所スタックを管理するには、次のように PowerShell Location コマンドレットを使用します。

• 場所スタックに場所を追加するには、Push-Location コマンドレットを使用します。
• 場所スタックから場所を取得するには、Pop-Location コマンドレットを使用します。
• 現在の場所スタックの場所を表示するには、 コマンドレットの Get-Location パラメーターを使用します。

名前付き場所スタックに場所を表示するには、 コマンドレットの Get-Location パラメーターを使用します。

• 新しい場所スタックを作成するには、Push-Location コマンドレットの StackName パラメーターを使用します。 存在しないスタックを指定した場合は、スタック Push-Location 作成されます。
• 場所スタックを現在の場所スタックにするには、Set-Location コマンドレットの StackName パラメーターを使用します。

名前のない既定の場所スタックは、現在の場所スタックである場合にのみ完全にアクセスできます。 名前付きの場所スタックを現在の場所スタックにすると、 Push-Location または Pop-Location コマンドレットを使用して既定のスタックから項目を追加または取得したり、 Get-Location コマンドを使用して名前のないスタック内の場所を表示したりすることはできなくなります。 名前のないスタックを現在のスタックにするには、 Set-Location コマンドレットの StackName パラメーターを $null の値または空の文字列 ("") と共に使用します。

また、組み込みのエイリアス、Push-Locationで pushd を参照することもできます。 詳細については、about_Aliasesを参照してください。

Push-Location コマンドレットは、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。