Get-RMSFileStatus

Referencia

Modul:: AzureInformationProtection

Lekéri egy adott fájl RMS-védelmi állapotát.

Syntax

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

Description

A Get-RMSFileStatus parancsmag visszaadja egy adott fájl védelmi állapotát (függetlenül attól, hogy a fájlt a Rights Management védi-e vagy sem).

A védett fájlok védett (natív) vagy védett (általános) állapotúak, a nem védett fájlok pedig nem védettek.

Vegye figyelembe, hogy egy natív védelem alatt álló tárolófájl, például egy Outlook-adatfájl (. PST) mindig a Nem védett védelmi állapotot adja vissza.

Példák

1. példa: Egy megadott fájl védelmi állapotának listázása

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

Ez a parancs a megadott fájlC:\Test.docxRights Management védelmi állapotát sorolja fel .

Mivel egy .docx fájlnévkiterjesztéssel rendelkező fájl támogatja a natív védelmet, az állapot a "Védett (natív)" vagy a "Nem védett" értéket adja vissza.

2. példa: A mappa összes fájljának és almappájának védelmi állapotának listázása

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

Bár a Get-RMSFileStatus parancsmag egyszerre egy fájlhoz működik, a következő Windows PowerShell paranccsal lekérheti egy mappában (a példánkban c:\Documents néven) lévő összes fájl állapotát és almappáit.

Ugyanez a parancs használható UNC elérési úttal meghajtó és elérési út helyett.

3. példa: Hozzon létre egy .CSV fájlt a mappában és az almappákban lévő összes fájl védelmi állapotával

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

Az előző példát tovább bővítheti, ha az eredményeket egy .CSV fájlba adja ki, hogy rendezhesse és rendezhesse az információkat.

Ebben a példában a .CSV fájl neveProtectedFilesList.csv , és a C:\Temp mappába van mentve. Ha a fájl már létezik, felül lesz írva.

Paraméterek

-File

Megadja a fájl teljes elérési útját annak ellenőrzéséhez, hogy a Rights Management védi-e.

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