Get-Item

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<CommonParameters>]

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

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

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

Get-Item .

Directory: C:\

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

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

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

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

Get-Item C:

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

Get-Item C:\*

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

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

(Get-Item C:\Windows).LastAccessTime

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

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

この例では、ドット (.) を含む名前を持つ Windows ディレクトリ内の項目を取得しますが、w*で始まっていません。この例は、項目の内容を指定するワイルドカード文字 (*) がパスに含まれている場合にのみ機能します。

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

PowerShell 6.2 では、ハードリンク情報を取得するための代替ビューが追加されました。 ハードリンク情報を取得するには、出力を Format-Table -View childrenWithHardlink にパイプします

Get-Item C:\Windows\System32\ntoskrnl.exe |
    Format-Table -View childrenWithHardLink

    Directory: C:\Windows\System32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---           5/12/2021  7:40 AM       10848576 ntoskrnl.exe

Mode プロパティは、l の la--- によってハードリンクを識別します。

Unix システム上の PowerShell 7.1 では、Get-Item コマンドレットは Unix に似た出力を提供します。

PS> Get-Item /Users

    Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

出力の一部になった新しいプロパティは次のとおりです。

• UnixMode は、Unix システムで表されるファイルのアクセス許可です
• ユーザー がファイル所有者である
• グループ がグループ の所有者である
• サイズ は、Unix システムで表されるファイルまたはディレクトリのサイズです

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

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

コマンドレットは、Alias: ドライブにアクセスするときにこの種類を出力します。

コマンドレットは、Cert: ドライブにアクセスするときにこれらの型を出力します。

コマンドレットは、Env: ドライブにアクセスするときにこの種類を出力します。

このコマンドレットは、FileSystem ドライブにアクセスするときにこれらの種類を出力します。

コマンドレットは、Function: ドライブにアクセスするときにこれらの型を出力します。

このコマンドレットは、レジストリ ドライブにアクセスするときにこの種類を出力します。

コマンドレットは、Variable: ドライブにアクセスするときにこの種類を出力します。

コマンドレットは、WSMan: ドライブにアクセスするときにこれらの型を出力します。

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

• すべてのプラットフォーム:
  • gi

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

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

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