Get-RMSFileStatus
取得指定檔案的 RMS 保護狀態。
Syntax
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 保護。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |