次の方法で共有

Push-Location

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

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

構文

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

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

型:String
Aliases:PSPath, LP
配置: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を参照してください。

手記

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

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

入力

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