通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-RMSFileStatus

  • 参考
模块:
AzureInformationProtection

获取指定文件的 RMS 保护状态。

语法

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

说明

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 保护。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False