Find-PnPFile

Finds a file in the virtual file system of the web.

Syntax

Find-PnPFile
    -Match <String>
                [-Web <WebPipeBind>]
                [-Connection <SPOnlineConnection>]
Find-PnPFile
    -Match <String>
                -List <ListPipeBind>
                [-Web <WebPipeBind>]
                [-Connection <SPOnlineConnection>]
Find-PnPFile
    -Match <String>
                -Folder <FolderPipeBind>
                [-Web <WebPipeBind>]
                [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Find-PnPFile -Match *.master

Will return all masterpages located in the current web.

------------------EXAMPLE 2------------------

Find-PnPFile -List "Documents" -Match *.pdf

Will return all pdf files located in given list.

------------------EXAMPLE 3------------------

Find-PnPFile -Folder "Shared Documents/Sub Folder" -Match *.docx

Will return all docx files located in given folder.

Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Folder

Folder object or relative url of a folder to query

Type:FolderPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-List

List title, url or an actual List object to query

Type:ListPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Match

Wildcard query

Type:String
Position:0
Accept pipeline input:True
Accept wildcard characters:False
-Web

This parameter allows you to optionally apply the cmdlet action to a subweb within the current web. In most situations this parameter is not required and you can connect to the subweb using Connect-PnPOnline instead. Specify the GUID, server relative url (i.e. /sites/team1) or web instance of the web to apply the command to. Omit this parameter to use the current web.

Type:WebPipeBind
Position:Named
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.SharePoint.Client.File