Get-RMSFileStatus

Referens

Modul:: AzureInformationProtection

Hämtar RMS-skyddsstatusen för en angiven fil.

Syntax

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

Description

Cmdleten Get-RMSFileStatus returnerar skyddsstatusen (oavsett om filen skyddas av Rights Management eller inte) för en angiven fil.

En skyddad fil har statusen Skyddad (intern) eller Skyddad (generisk) och en oskyddad fil har statusen Oskyddad.

Observera att en internt skyddad containerfil, till exempel en Outlook-datafil (. PST) returnerar alltid skyddsstatusen för Oskyddad.

Exempel

Exempel 1: Ange skyddsstatus för en angiven fil

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

Det här kommandot visar Rights Management-skyddsstatus för den angivna filen C:\Test.docx.

Eftersom en fil med filnamnstillägget.docx stöder internt skydd returnerar statusen "Skyddad (intern)" eller "Oskyddad".

Exempel 2: Ange skyddsstatus för alla filer i en mapp och eventuella undermappar

PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}

Även om cmdleten Get-RMSFileStatus fungerar för en fil i taget kan du använda följande Windows PowerShell kommando för att hämta status för alla filer i en mapp (i vårt exempel med namnet C:\Documents) och dess undermappar.

Samma kommando kan användas med en UNC-sökväg i stället för en enhet och sökväg.

Exempel 3: Skapa en .CSV fil med skyddsstatus för alla filer i en mapp och eventuella undermappar

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

Du kan utöka föregående exempel ytterligare genom att mata ut resultatet till en .CSV fil, så att du kan sortera och sortera informationen.

I det här exemplet heter .CSV-filen ProtectedFilesList.csv och sparas i mappen C:\Temp . Om filen redan finns skrivs den över.

Parametrar

-File

Anger den fullständigt kvalificerade sökvägen till filen för att kontrollera om den skyddas av Rights Management.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False