Set-Location
現在の作業場所を、指定された場所に設定します。
構文
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
説明
Set-Location コマンドレットは、作業場所を指定された場所に設定します。指定できる場所は、ディレクトリ、サブディレクトリ、レジストリの場所、別の場所スタックです。
パラメーター
-LiteralPath <string>
場所のパスを指定します。LiteralPath パラメーターの値は入力したとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符で囲んだ文字はエスケープ シーケンスとして解釈されません。
必須 |
true |
位置 |
1 |
既定値 |
|
パイプライン入力を許可する |
true (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PassThru
場所を表すオブジェクトをパイプラインに渡します。既定では、このコマンドレットによる出力はありません。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Path <string>
このパラメーターを使用して、新しい作業場所のパスを指定します。
必須 |
false |
位置 |
1 |
既定値 |
|
パイプライン入力を許可する |
true (ByValue, ByPropertyName) |
ワイルドカード文字を許可する |
false |
-StackName <string>
場所を設定するスタックの名前です。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
true (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UseTransaction
コマンドを有効なトランザクションに含めます。このパラメーターは、トランザクションの進行中のみ有効です。詳細については、「about_Transactions」を参照してください。
必須 |
false |
位置 |
named |
既定値 |
|
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.
入力と出力
入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。
入力 |
System.String パイプを使用してパス (リテラル パスではない) を含む文字列を Set-Location に渡すことができます。 |
出力 |
なし、または System.Management.Automation.PathInfo PassThru パラメーターを使用すると、Set-Location は場所を表す System.Management.Automation.PathInfo オブジェクトを生成します。それ以外の場合、このコマンドレットによる出力はありません。 |
注
Set-Location コマンドレットは、プロバイダーによって公開されているデータを使用するように設計されています。セッションで使用可能なプロバイダーの一覧を表示するには、「Get-PSProvider」と入力します。詳細については、「about_Providers」を参照してください。
例 1
C:\PS>set-location HKLM:
説明
-----------
このコマンドを実行すると、指定した場所 (ここでは HKLM プロバイダー) が現在の場所になります。
例 2
C:\PS>set-location env: -passthru
Path
----
Env:\
説明
-----------
このコマンドを実行すると、指定した場所 (ここでは環境変数プロバイダー) が現在の場所になります。
例 3
C:\PS>set-location C:
説明
-----------
このコマンドを実行すると、指定した場所 (ここではファイル システム プロバイダーの C: ドライブ) が現在の場所になります。