Set-Location

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

現在の作業場所を、指定された場所に設定します。

構文

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

説明

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

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

例

例 1: 現在の場所を設定する

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

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

例 2: 現在の場所を設定し、その場所を表示する

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

Path
----
Env:\

PS Env:\>

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

例 3: C: ドライブの現在の場所に場所を設定する

PS C:\Windows\> Set-Location HKLM:\
PS HKLM:\> Set-Location C:
PS C:\Windows\>

最初のコマンドは、レジストリ プロバイダーのドライブの HKLM: ルートに場所を設定します。 2 番目のコマンドは、FileSystem プロバイダー内のドライブの現在の C: 場所に場所を設定します。 ドライブ名が (円記号を使用せずに) フォーム <DriveName>: で指定されている場合、コマンドレットは PSDrive 内の現在の場所に場所を設定します。 PSDrive の現在の場所を取得するには、コマンドを使用 Get-Location -PSDrive <DriveName> します。

例 4: 現在の場所を名前付きスタックに設定する

PS C:\> Push-Location -Path 'C:\Program Files\PowerShell\' -StackName "Paths"
PS C:\Program Files\PowerShell\> Set-Location -StackName "Paths"
PS C:\Program Files\PowerShell\> Get-Location -Stack

Path
----
C:\

最初のコマンドは、現在の場所をパス スタックに追加します。 2 番目のコマンドは、パスの場所スタックを現在の場所スタックにします。 3 番目のコマンドは、現在の場所スタック内の場所を表示します。

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

パラメーター

-LiteralPath

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

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

新しい作業場所のパスを指定します。 パスが指定されていない場合は、 Set-Location 既定で現在のユーザーのホーム ディレクトリが使用されます。 ワイルドカードを使用すると、コマンドレットは、野生のカード パターンに一致するコンテナー (ディレクトリ、レジストリ キー、証明書ストア) を選択します。 ワイルドカード パターンが複数のコンテナーと一致する場合、コマンドレットはエラーを返します。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-StackName

このコマンドレットで現在の場所スタックを作成する既存の場所スタック名を指定します。 場所スタック名を入力します。 名前のない既定の場所スタックを示すには、空の文字列 ("") を入力$nullします。

このパラメーターを使用しても、現在の場所は変更されません。 コマンドレットによって *-Location 使用されるスタックのみが変更されます。 StackName パラメーターを使用して別のスタックを指定しない限り、コマンドレットは*-Location現在のスタックで動作します。 場所スタックの詳細については、「メモ」を参照してください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseTransaction

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

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

リテラル パスではなくパスを含む文字列をこのコマンドレットにパイプできます。

出力

None

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

PathInfo

Path または LiteralPath で PassThru パラメーターを使用すると、このコマンドレットは新しい場所を表す PathInfo オブジェクトを返します。

PathInfoStack

StackName で PassThru パラメーターを使用すると、このコマンドレットは新しいスタック コンテキストを表す PathInfoStack オブジェクトを返します。

メモ

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

  • cd
  • chdir
  • sl

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

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

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

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

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

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

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

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

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

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

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