Delen via

Get-RMSFileStatus

  • Referentie
Module:
AzureInformationProtection

Hiermee haalt u de RMS-beveiligingsstatus van een opgegeven bestand op.

Syntaxis

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

Description

De cmdlet Get-RMSFileStatus retourneert de beveiligingsstatus (ongeacht of het bestand wordt beveiligd door Rights Management of niet) van een opgegeven bestand.

Een beveiligd bestand heeft de status Beveiligd (Systeemeigen) of Beveiligd (Algemeen) en een niet-beveiligd bestand heeft de status Niet-beveiligd.

Houd er rekening mee dat een systeemeigen beveiligd containerbestand, zoals een Outlook-gegevensbestand (. PST) retourneert altijd de beveiligingsstatus van Niet-beveiligd.

Voorbeelden

Voorbeeld 1: De beveiligingsstatus voor een opgegeven bestand weergeven

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

Met deze opdracht wordt de Rights Management-beveiligingsstatus voor het opgegeven bestand C:\Test.docxvermeld.

Omdat een bestand met een .docx bestandsnaamextensie systeemeigen beveiliging ondersteunt, retourneert de status 'Beveiligd (systeemeigen)' of 'Niet-beveiligd'.

Voorbeeld 2: De beveiligingsstatus voor alle bestanden in een map en eventuele submappen weergeven

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

Hoewel de cmdlet Get-RMSFileStatus voor één bestand tegelijk werkt, kunt u de volgende Windows PowerShell opdracht gebruiken om de status van alle bestanden in een map (in ons voorbeeld C:\Documents) en de bijbehorende submappen op te halen.

Dezelfde opdracht kan worden gebruikt met een UNC-pad in plaats van een station en pad.

Voorbeeld 3: Een .CSV-bestand maken met de beveiligingsstatus voor alle bestanden in een map en eventuele submappen

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

U kunt het vorige voorbeeld verder uitbreiden door de resultaten uit te voeren naar een .CSV-bestand, zodat u de gegevens kunt sorteren en ordenen.

In dit voorbeeld heet het .CSV bestand ProtectedFilesList.csv en opgeslagen in de map C:\Temp . Als het bestand al bestaat, wordt dit overschreven.

Parameters

-File

Hiermee geeft u het volledig gekwalificeerde pad naar het bestand op om te controleren of het wordt beveiligd door Rights Management.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False