Skip to content

Latest commit

 

History

History
67 lines (44 loc) · 2.12 KB

File metadata and controls

67 lines (44 loc) · 2.12 KB
external help file Module Name online version applicable title schema author ms.author ms.reviewer
sharepointonline.xml
Microsoft.Online.SharePoint.PowerShell
SharePoint Online
Get-SPOMalwareFile
2.0.0
vinandi
vinandi

Get-SPOMalwareFile

SYNOPSIS

Extracts and displays the malware-related information of an infected file stored in SharePoint.

SYNTAX

Get-SPOMalwareFile -FileUri <String> [<CommonParameters>]

DESCRIPTION

The Get-SPOMalwareFile cmdlet runs on a single file. If the file is malware-infected then it returns an object of the type SPOMalwareFile which contains siteURL, filePath, malwareStatus flag, and malwareInfo (if applicable). You must be a SharePoint Online administrator to run the Get-SPOMalwareFile cmdlet. Note that this cmdlet does not work on files that are not malware-infected.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

EXAMPLES

EXAMPLE 1

 Get-SPOMalwareFile -FileUri "https://contoso.com/sites/Marketing/Shared Documents/Doc1.docx"

Example 1 returns an object of the type SPOMalwareFile which contains siteURL, filePath, malwareStatus flag, and malwareInfo (if applicable).

PARAMETERS

-FileUri

Full URL for the file.

Type: String
Parameter Sets: (All)
Aliases:
Applicable: SharePoint Online

Required: True
Position: Named
Default value: None

NOTES

The Get-SPOMalwareFile cmdlet returns an object of the type SPOMalwareFile. To get the file stream of the infected file, pass this object as a parameter to the Get-SPOMalwareFileContent cmdlet.

RELATED LINKS

Get-SPOMalwareFileContent

Getting started with SharePoint Online Management Shell