Push-Location

構文

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

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

説明

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

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

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

例

例 1

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

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

例 2

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

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

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

例 3

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

PS C:\> Push-Location

例 4 - 名前付きスタックを作成して使用する

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

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

最初のコマンドは、現在の場所を Stack2 という名前の新しいスタックにプッシュし、現在の場所をホーム ディレクトリに変更します。これは、FileSystem プロバイダー ドライブで使用される場合、$HOMEと同じチルダ 記号 (~) で表されます。

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

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

パラメーター

-LiteralPath

-PassThru

-Path

-StackName

入力

String

このコマンドレットへのパス (リテラル パスは含まない) を含む文字列をパイプ処理できます。

出力

None

既定では、このコマンドレットは出力を返しません。

PathInfo

PassThru パラメーターを使用すると、このコマンドレットは、コマンドレットの操作後の現在のパスを表すPathInfo オブジェクトを返します。

メモ

PowerShell には、 Push-Locationの次のエイリアスが含まれています。

• すべてのプラットフォーム:
  • pushd

PowerShell では、プロセスごとに複数の実行空間がサポートされます。 各実行空間には、独自の 現在のディレクトリがあります。 これは、 [System.Environment]::CurrentDirectoryと同じではありません。 この動作は、.NET API を呼び出したり、明示的なディレクトリ パスを指定せずにネイティブ アプリケーションを実行したりする場合に問題になる可能性があります。

場所コマンドレットによってプロセス全体の現在のディレクトリが設定された場合でも、別の実行空間によっていつでも変更される可能性があるため、それに依存することはできません。 location コマンドレットを使用して、現在の実行空間に固有の現在の作業ディレクトリを使用してパスベースの操作を実行する必要があります。

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

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

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

• 場所スタックに場所を追加するには、 Push-Location コマンドレットを使用します。

• 場所スタックから場所を取得するには、 Pop-Location コマンドレットを使用します。

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

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

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

• 場所スタックを現在の場所スタックにするには、 Set-Location コマンドレットの StackName パラメーターを使用します。

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

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

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

関連リンク

• Get-Location
• Pop-Location
• Set-Location
• about_Aliases
• about_Providers