Get-SPOMalwareFileContent
取得與儲存在 SharePoint 中的受惡意程式碼感染檔案相關聯的檔案串流。
語法
Default (預設值)
Get-SPOMalwareFileContent
[-MalwareInfectedFile] <SPOMalwareFile>
[<CommonParameters>]
Description
Cmdlet 會在 Get-SPOMalwareFileContent 單一檔案上執行。 如果檔案受惡意程式碼感染,則會傳回與其相關聯的檔案串流。 您必須是 SharePoint 線上系統管理員才能執行 Get-SPOMalwareFileContent Cmdlet。 請注意,此 Cmdlet 無法在未受惡意軟體感染的檔案上運作。
如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊,請參閱位於 SharePoint Online 管理命令介面 簡介的線上文件。
範例
範例 1
$file = Get-SPOMalwareFile -FileUri "https://contoso.com/sites/Marketing/Shared Documents/Doc1.docx"
Get-SPOMalwareFileContent -MalwareInfectedFile $file
範例 1 會傳回檔案資料流。
範例 2
Get-SPOMalwareFile -FileUri "https://contoso.com/sites/Marketing/Shared Documents/Doc1.docx" | Get-SPOMalwareFileContent
範例 2 會傳回檔案串流。
範例 3
$spoFileUri = "https://contoso.com/sites/Marketing/Shared Documents/Doc1.docx"
$fileName = $spoFileUri.split("/")[-1]
$localFolder = "C:\temp\$fileName"
$targetfile = New-Object IO.FileStream ($localFolder,[IO.FileMode]::Create)
[byte[]]$readbuffer = New-Object byte[] 1024
$file = Get-SPOMalwareFile -FileUri $spoFileUri
$responseStream = Get-SPOMalwareFileContent -MalwareInfectedFile $file
do{
$readlength = $responsestream.Read($readbuffer,0,1024)
$targetfile.Write($readbuffer,0,$readlength)
}
while ($readlength -ne 0)
$targetfile.close()
範例 3 使用原始檔案名稱將檔案下載到目前的工作目錄。
參數
-MalwareInfectedFile
適用對象:SharePoint Online
SPOMalwareFile Cmdlet 傳回的 Get-SPOMalwareFile 物件。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantAdministration.SPOMalwareFile |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Microsoft.Online.SharePoint.TenantAdministration.SPOMalwareFile
輸出
System.Object
備註
若要取得 SPOMalwareFile 物件,使用者應先執行 Get-SPOMalwareFile Cmdlet。 然後該物件即可當做 Cmdlet 的 Get-SPOMalwareFileContent 參數使用。