Get-RMSFileStatus cmdlet 返回保护状态 (文件是否受指定文件的 Rights) Management 保护。

受保护的文件的状态为 Protected (Native) 或 Protected (Generic) ，且未受保护的文件的状态为 “未保护 ”。

请注意，本机保护的容器文件，例如 Outlook 数据文件 (。PST) 始终返回“未保护”的保护状态。

示例 1：列出指定文件的保护状态

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

此命令列出指定文件 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 保护。