Get-RMSFileStatus
取得指定檔案的 RMS 保護狀態。
語法
Get-RMSFileStatus
-File <String>
[<CommonParameters>]
Description
Get-RMSFileStatus Cmdlet 會傳回保護狀態, (檔案是否受到指定檔案) 保護。
受保護的檔案的狀態為 Protected (Native) 或 Protected (Generic) ,且未受保護的檔案的狀態為 [未受保護]。
請注意,原生保護的容器檔案,例如 Outlook 資料檔案 (。PST) 一律會傳回 [未保護] 的保護狀態。
範例
範例 1:列出指定檔案的保護狀態
PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName Status
-------- ------
C:\Test.docx Unprotected
此命令會列出指定檔案的 Rights Management 保護狀態 ,C:\Test.docx。
因為副檔名 為.docx的 檔案支援原生保護,所以狀態會傳回「受保護的 (原生) 」或「未保護」。
範例 2:列出資料夾和任何子資料夾中所有檔案的保護狀態
PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}
雖然Get-RMSFileStatus Cmdlet 一次適用于一個檔案,但您可以使用下列Windows PowerShell命令來取得範例中資料夾 (中所有檔案的狀態,名為C:\Documents) 及其子資料夾。
相同的命令可以搭配 UNC 路徑使用,而不是磁片磁碟機和路徑。
範例 3:建立.CSV檔案,其中包含資料夾和任何子資料夾中所有檔案的保護狀態
PS C:\>$(foreach ($file in (Get-ChildItem -Path C:\Documents\ -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}) | Export-Csv -Path C:\Temp\ProtectedFilesList.csv -Encoding ascii -NoTypeInformation
您可以將結果輸出至.CSV檔案,以進一步擴充上述範例,以便排序及排序資訊。
在此範例中, .CSV 檔案會命名 為ProtectedFilesList.csv ,並儲存至 C:\Temp 資料夾。 若此檔案已經存在,其將會覆寫該檔案。
參數
-File
指定檔案的完整路徑,以驗證檔案是否受到 Rights Management 保護。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |