次の方法で共有

Get-Item

モジュール:
Microsoft.PowerShell.Management

指定した場所にある項目を取得します。

構文

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]
Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]

説明

Get-Item コマンドレットは、指定した場所にある項目を取得します。 ワイルドカード文字 ('*') を使用してアイテムのすべてのコンテンツを要求しない限り、その場所にあるアイテムの内容は取得されません。

このコマンドレットは、さまざまな種類のデータ ストア間を移動するために PowerShell プロバイダーによって使用されます。

例

例 1: 現在のディレクトリを取得する

このコマンドは、現在のディレクトリを取得します。 ドット ('.') は、現在の場所にある項目を表します (内容ではありません)。

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

例 2: 現在のディレクトリ内のすべての項目を取得する

このコマンドは、現在のディレクトリ内のすべての項目を取得します。 ワイルドカード文字 ('*') は、現在のアイテムのすべての内容を表します。

Get-Item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

例 3: ドライブの現在のディレクトリを取得する

このコマンドは、C: ドライブのカレントディレクトリを取得します。 取得されるオブジェクトは、その内容ではなく、ディレクトリのみを表します。

Get-Item C:\

例 4: 指定したドライブ内の項目を取得する

このコマンドは、C: ドライブ内の項目を取得します。 ワイルドカード文字 ('*') は、コンテナだけでなく、コンテナ内のすべての項目を表します。

PowerShell では、従来の "" の代わりに 1 つのアスタリスク ('') を使用してコンテンツを取得します。"。この形式は文字通りに解釈されるため、".*" はドットなしではディレクトリやファイル名を取得しません。

Get-Item C:\*

例 5: 指定したディレクトリ内のプロパティを取得する

このコマンドは、"C:\Windows" ディレクトリの LastAccessTime プロパティを取得します。 LastAccessTime は、ファイル システム ディレクトリの 1 つのプロパティにすぎません。 ディレクトリのすべてのプロパティを表示するには、「 (Get-Item \<directory-name\>) | Get-Member」と入力します。

(Get-Item C:\Windows).LastAccessTime

例 6: レジストリ キーの内容を表示する

このコマンドは、 Microsoft.PowerShell レジストリ キーの内容を表示します。 このコマンドレットを PowerShell レジストリ プロバイダーと共に使用してレジストリ キーとサブキーを取得できますが、レジストリ値とデータを取得するには Get-ItemProperty コマンドレットを使用する必要があります。

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

例 7: 除外があるディレクトリ内の項目を取得する

このコマンドは、Windows ディレクトリ内の項目を、ドット ('.') を含む名前で、"w*" で始まらないものを取得します。 このコマンドは、アイテムの内容を指定するためのワイルドカード文字 ('*') がパスに含まれている場合にのみ機能します。

Get-Item c:\Windows\*.* -Exclude "w*"

パラメーター

-Credential

このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。

"User01" や "Domain01\User01" などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credential コマンドレットによって生成されたものなど) を入力します。 ユーザー名を入力すると、パスワードの入力を求められます。

Warnung

このパラメーターは、Windows PowerShell でインストールされているプロバイダーではサポートされていません。

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

-Exclude

文字列配列として、このコマンドレットが操作で除外する項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 "*.txt" などのパス要素またはパターンを入力します。 ワイルドカード文字を使用できます。

Exclude パラメーターは、コマンドに項目の内容 ("C:\Windows*" など) が含まれている場合にのみ有効です。ワイルドカード文字は "C:\Windows" ディレクトリの内容を指定します。

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

-Filter

プロバイダーの形式または言語でフィルターを指定します。 このパラメーターの値は、Path パラメーターを修飾します。

ワイルドカード文字の使用を含むフィルターの構文は、プロバイダーによって異なります。 フィルターは、取得後に PowerShell でオブジェクトをフィルター処理するのではなく、コマンドレットがオブジェクトを取得するときにプロバイダーによって適用されるため、他のパラメーターよりも効率的です。

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

-Force

このコマンドレットが、非表示のアイテムなど、他の方法ではアクセスできないアイテムを取得することを示します。 実装はプロバイダーによって異なります。 詳細については、about_Providersを参照してください。 Force パラメーターを使用しても、コマンドレットはセキュリティ制限をオーバーライドできません。

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

-Include

文字列配列として、このコマンドレットが操作に含める項目を指定します。 このパラメーターの値は、Path パラメーターを修飾します。 "*.txt" などのパス要素またはパターンを入力します。 ワイルドカード文字を使用できます。

Include パラメーターが有効なのは、コマンドに項目の内容が含まれる場合 (たとえば、"C:\Windows*" (ワイルドカード文字で "C:\Windows" ディレクトリの内容を指定する場合など) のみです。

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

-LiteralPath

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

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

-Path

項目へのパスを指定します。 このコマンドレットは、指定した場所にある項目を取得します。 ワイルドカードを使用できます。 このパラメータは必須ですが、パラメータ名 ("Path") はオプションです。

ドット ('.') を使用して、現在の位置を指定します。 ワイルドカード文字 ('*') を使用して、現在のロケーションにあるすべてのアイテムを指定します。

型:String[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-Stream

指定した代替 NTFS ファイル ストリームをファイルから取得します。 ストリーム名を入力します。 ワイルドカードがサポートされています。 すべてのストリームを取得するには、アスタリスク (*) を使用します。 このパラメータは、フォルダに対しては無効です。

Stream は、FileSystem プロバイダーが Get-Item コマンドレットに追加する動的パラメーターです。 このパラメーターは、ファイル システム ドライブでのみ機能します。

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

-UseTransaction

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

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

入力

String

このコマンドレットへのパスを含む文字列をパイプ処理できます。

出力

Object

このコマンドレットは、取得したオブジェクトを返します。 タイプは、パス内のオブジェクトのタイプによって決まります。

メモ

このコマンドレットは、Recurse パラメーターを持っていません。これは、その内容ではなく項目のみを取得するためです。 項目の内容を再帰的に取得するには、Get-ChildItemを使用します。

レジストリ内を移動するには、このコマンドレットを使用してレジストリ キーを取得し、レジストリ値とデータを取得する Get-ItemProperty を取得します。 レジストリ値は、レジストリ キーのプロパティと見なされます。

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