次の方法で共有

Push-Location

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

現在の場所を、場所スタックの最上部に追加します。

構文

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 作成します。

場所スタックの詳細については、「 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

新しい場所のパスを指定します。 Path パラメーターとは異なり、LiteralPath パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。

型:String
Aliases:PSPath
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

場所を表すオブジェクトをパイプラインに渡します。 既定では、このコマンドレットによる出力はありません。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

現在の場所をスタックの最上部に追加 (プッシュ) してから、このパスが示す場所に移動します。 このコマンドレットをサポートするプロバイダーの任意のパスを入力します。 ワイルドカードを使用できます。 パラメーター名は省略可能です。

型:String
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-StackName

現在の場所を追加する場所スタックを指定します。 場所スタック名を入力します。 スタックが存在しない場合は、 Push-Location 作成します。

このパラメーターを指定しない場合、 Push-Location は現在の場所スタックに場所を追加します。 既定では、現在の場所スタックは、PowerShell によって作成される名前のない既定の場所スタックです。 場所スタックを現在の場所スタックにするには、Set-Location コマンドレットの StackName パラメーターを使用します。 場所スタックの詳細については、「 Notes」を参照してください。

Note

Push-Location は、現在の場所スタックでない限り、名前のない既定のスタックに場所を追加できません。

型:String
配置:Named
規定値:Default stack
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-UseTransaction

アクティブなトランザクションのコマンドが含まれます。 このパラメーターは、トランザクションが進行中の場合のみ有効です。 詳細については、「 about_Transactions」を参照してください。

型:SwitchParameter
Aliases:usetx
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

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

出力

None

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

PathInfo

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

メモ

Windows 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」を参照してください。