Export (0) Print
Expand All

Get-Item for FileSystem

Updated: May 8, 2014

Applies To: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0

Gets files and folders.

Syntax

Get-Item [-Stream <string>] [<CommonParameters>]

Description

In the file system, the Get-Item cmdlet gets files and folders.

Note: This custom cmdlet help file explains how the Get-Item cmdlet works in a file system drive. For information about the Get-Item cmdlet in all drives, type "Get-HelpGet-Item -Path $null" or see Get-Item at http://go.microsoft.com/fwlink/?LinkID=113319.

Parameters

-Stream <string>

Gets the specified alternate NTFS file stream from the file. Enter the stream name. Wildcards are supported. To get all streams, use an asterisk (*). This parameter is not valid on folders.

Stream is a dynamic parameter that the FileSystem provider adds to the Get-Item cmdlet. This parameter works only in file system drives.

This parameter is introduced in Windows PowerShell 3.0.

 

Required?

false

Position?

named

Default Value

No alternate file streams

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

 

Inputs

System.String[ ]

You can pipe a path to the Get-Item cmdlet.

Outputs

System.IO.FileInfo, System.IO.DirectoryInfo, Microsoft.PowerShell.Commands.AlternateStreamData

In the file system, Get-Item returns files and folders. If you use the Stream parameter, it returns AlternateStreamData objects.

Example 1

C:\PS>Get-Item C:\Users\User01\Downloads\InternetFile.docx -Stream *

   FileName: C:\Users\User01\Downloads\InternetFile.docx

Stream                   Length
------                   ------
:$DATA                    45056
Zone.Identifier              26

Description
-----------
This command gets all stream data from a file that was downloaded from the Internet. The Zone.Identifier stream identifies a file that originated on the Internet. The $DATA stream is the default.

The Stream parameter is introduced in Windows PowerShell 3.0.







Example 2

C:\PS>Get-Item C:\ps-test\* -Stream Zone.Identifier -ErrorAction SilentlyContinue


   FileName: C:\ps-test\Copy-Script.ps1

Stream                   Length
------                   ------
Zone.Identifier              26


   FileName: C:\ps-test\Start-ActivityTracker.ps1

Stream                   Length
------                   ------
Zone.Identifier              26

Description
-----------
This command gets Zone.Identifier stream data from all files in the C:\ps-test directory. The command uses the Stream parameter to specify the alternate stream and he ErrorAction parameter with a value of SilentlyContinue to suppress non-terminating errors that are generated when a file has no alternate data streams. 

The Stream parameter is introduced in Windows PowerShell 3.0.







Example 3

C:\PS>Get-Item .

Directory: C:\

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

Description
-----------
This command gets the current directory. The dot (.) represents the item at the current location (not its contents).







Example 4

C:\PS>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

Description
-----------
This command gets the current directory of the C: drive. The object that is retrieved represents only the directory, not its contents.







Example 5

C:\PS>Get-Item C:\

Description
-----------
This command gets the items in the C: drive. The wildcard character (*) represents all the items in the container, not just the container.

In Windows PowerShell, use a single asterisk (*) to get contents, instead of the traditional "*.*". The format is interpreted literally, so "*.*" would not retrieve directories or file names without a dot.







Example 6

C:\PS>(Get-Item C:\Windows).LastAccessTime

Description
-----------
This command gets the LastAccessTime property of the C:\Windows directory. LastAccessTime is just one property of file system directories. To see all of the properties of a directory, type "(Get-Item <directory-name>) | Get-Member".







Example 7

C:\PS>Get-Item C:\Windows\*.* -Exclude w*

Description
-----------
This command gets items in the Windows directory with names that include a dot (.), but do not begin with w*. This command works only when the path includes a wildcard character (*) to specify the contents of the item.







See Also



Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft