Push-Location
現在の場所を、場所スタックの最上部に追加します。
構文
Push-Location
[[-Path] <String>]
[-PassThru]
[-StackName <String>]
[<CommonParameters>]
Push-Location
[-LiteralPath <String>]
[-PassThru]
[-StackName <String>]
[<CommonParameters>]
説明
コマンドレットは Push-Location
、現在の場所を場所スタックに追加 ("pushes") します。 パスを指定した場合は、 Push-Location
現在の場所を場所スタックにプッシュし、現在の場所をパスで指定された場所に変更します。 コマンドレットを Pop-Location
使用して、場所スタックから場所を取得できます。
既定では、コマンドレットはPush-Location
現在の場所を現在の場所スタックにプッシュしますが、StackName パラメーターを使用して別の場所スタックを指定できます。 スタックが存在しない場合は、 Push-Location
作成します。
場所スタックの詳細については、「メモ」を参照してください。
例
例 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
名前のない既定のスタックから場所がポップされます。
場所スタックの詳細については、「メモ」を参照してください。
パラメーター
-LiteralPath
新しい場所のパスを指定します。 Path パラメーターとは異なり、LiteralPath パラメーターの値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。 単一引用符は、エスケープ シーケンスとして文字を解釈しないように PowerShell に指示します。
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
場所を表すオブジェクトをパイプラインに渡します。 既定では、このコマンドレットによる出力はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
現在の場所をスタックの最上部に追加 (プッシュ) してから、このパスが示す場所に移動します。 このコマンドレットをサポートするプロバイダーの任意のパスを入力します。 ワイルドカードを使用できます。 パラメーター名は省略可能です。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-StackName
現在の場所を追加する場所スタックを指定します。 場所スタック名を入力します。
スタックが存在しない場合は、 Push-Location
作成します。
このパラメーターを指定しない場合は、 Push-Location
現在の場所スタックに場所を追加します。 既定では、現在の場所スタックは、PowerShell によって作成される名前のない既定の場所スタックです。
場所スタックを現在の場所スタックにするには、コマンドレットの StackName パラメーターを Set-Location
使用します。 場所スタックの詳細については、「メモ」を参照してください。
Note
Push-Location
は、現在の場所スタックでない限り、名前のない既定のスタックに場所を追加できません。
Type: | String |
Position: | Named |
Default value: | Default stack |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
入力
このコマンドレットへのパス (リテラル パスは含まない) を含む文字列をパイプ処理できます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは、コマンドレットの操作後の現在のパスを表す PathInfo オブジェクトを返します。
メモ
PowerShell には、次のエイリアスが Push-Location
含まれています。
- すべてのプラットフォーム:
pushd
PowerShell では、プロセスごとに複数の実行空間がサポートされます。 各実行空間には、独自 の現在のディレクトリがあります。
これは同じ [System.Environment]::CurrentDirectory
ではありません. この動作は、.NET API を呼び出したり、明示的なディレクトリ パスを指定せずにネイティブ アプリケーションを実行したりする場合に問題になる可能性があります。
場所コマンドレットによってプロセス全体の現在のディレクトリが設定された場合でも、別の実行空間によっていつでも変更される可能性があるため、それに依存することはできません。 location コマンドレットを使用して、現在の実行空間に固有の現在の作業ディレクトリを使用してパスベースの操作を実行する必要があります。
スタックは、最後に追加された項目にのみアクセスできる、最後に追加された先入れ先出しリストです。 使用した順序でスタックに項目を追加し、その後、逆の順序で使用するために項目を取得します。 PowerShell を使用すると、プロバイダーの場所を場所スタックに格納できます。
PowerShell では、名前のない既定の場所スタックが作成され、複数の名前付き場所スタックを作成できます。 スタック名を指定しない場合、PowerShell は現在の場所スタックを使用します。 既定では、名前のない既定の場所は現在の場所スタックですが、コマンドレットを Set-Location
使用して現在の場所スタックを変更できます。
場所スタックを管理するには、次のように PowerShell Location コマンドレットを使用します。
場所スタックに場所を追加するには、コマンドレットを
Push-Location
使用します。場所スタックから場所を取得するには、コマンドレットを
Pop-Location
使用します。現在の場所スタックの場所を表示するには、コマンドレットの Stack パラメーターを
Get-Location
使用します。名前付き場所スタックに場所を表示するには、コマンドレットの StackName パラメーターを
Get-Location
使用します。新しい場所スタックを作成するには、コマンドレットの StackName パラメーターを
Push-Location
使用します。 存在しないスタックを指定した場合は、Push-Location
スタックを作成します。場所スタックを現在の場所スタックにするには、コマンドレットの StackName パラメーターを
Set-Location
使用します。
名前のない既定の場所スタックは、現在の場所スタックになっている場合にだけ、完全にアクセスできます。
名前付き場所スタックを現在の場所スタックにした場合、そのコマンドレットを使用して既定のPush-Location
Pop-Location
スタックから項目を追加または取得したり、コマンドレットをGet-Location
使用して名前のないスタック内の場所を表示したりできなくなります。 名前のないスタックを現在のスタックにするには、コマンドレットの StackName パラメーターを値または空の$null
Set-Location
文字列 (""
) と共に使用します。
組み込みのエイリアスpushd
で参照Push-Location
することもできます。 詳細については、「about_Aliases」を参照してください。
コマンドレットは Push-Location
、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「.」と入力します Get-PSProvider
。 詳細については、「about_Providers」を参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示