Get-RMSFileStatus
Hiermee haalt u de RMS-beveiligingsstatus van een opgegeven bestand op.
Syntax
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 UnprotectedMet 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 -NoTypeInformationU 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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |