Set-Location

Set-Location
    [[-Path] <String>]
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

Set-Location
    -LiteralPath <String>
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

Set-Location
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Set-Location コマンドレットは、作業場所を指定した場所に設定します。 その場所には、ディレクトリ、サブディレクトリ、レジストリの場所、または任意のプロバイダー パスを指定できます。

StackName パラメーターを使用して、名前付き場所スタックを現在の場所スタックにすることもできます。 場所スタックの詳細については、「メモ」を参照してください。

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

このコマンドは、現在の場所を HKLM: ドライブのルートに設定します。

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

このコマンドは、現在の場所を Env: ドライブのルートに設定します。 PassThru パラメーターを使用して、場所を表す PathInfo オブジェクトを返すように PowerShell に Env: 指示します。

PS C:\> Set-Location C:

このコマンドは、FileSystem プロバイダーの現在の場所 C: ドライブを設定します。

PS C:\> Set-Location -StackName "WSManPaths"

このコマンドは、WSManPaths ロケーション・スタックを現在のロケーション・スタックにします。

*-Location コマンドレットは、コマンドで別の場所スタックが指定されていない限り、現在の場所スタックを使用します。 ロケーションスタックの詳細については、ノートを参照してください。

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

文字列に含まれるパスは、このコマンドレットにパイプできますが、リテラル パスはパイプできません。

このコマンドレットでは、 PassThru パラメーターを指定しない限り、出力は生成されません。 PassThru を Path または LiteralPath と共に使用すると、新しい位置を表す PathInfo オブジェクトが生成されます。 PassThru を StackName と共に使用すると、新しいスタック コンテキストを表す PathInfoStack オブジェクトが生成されます。

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

  スタックは、最後に追加された項目にのみアクセスできる、最後に追加された先入れ先出しリストです。 アイテムを使用する順序でスタックに追加し、逆の順序で使用するためにアイテムを取得します。 PowerShell を使用すると、プロバイダーの場所を場所スタックに格納できます。 PowerShell では、名前のない既定の場所スタックが作成されます。 複数の名前付き場所スタックを作成できます。 スタック名を指定しない場合、PowerShell は現在の場所スタックを使用します。 既定では、名前のない既定の場所は現在の場所スタックですが、Set-Location コマンドレットを使用して現在の場所スタックを変更できます。

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

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

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

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

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

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

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