Sdílet prostřednictvím

Get-RMSFileStatus

  • Reference
Modul:
AzureInformationProtection

Získá stav ochrany RMS zadaného souboru.

Syntax

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

Description

Rutina Get-RMSFileStatus vrátí stav ochrany (bez ohledu na to, jestli je soubor chráněný službou Rights Management nebo ne) zadaného souboru.

Chráněný soubor má stav Protected (Native) nebo Protected (Generic) a nechráněný soubor má stav Nechráněný.

Všimněte si, že nativně chráněný soubor kontejneru, například datový soubor Aplikace Outlook (. PST) vždy vrátí stav ochrany Nechráněný.

Příklady

Příklad 1: Výpis stavu ochrany pro zadaný soubor

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

Tento příkaz zobrazí stav ochrany Rights Management pro zadaný soubor C:\Test.docx.

Vzhledem k tomu, že soubor s příponou názvu souboru.docx podporuje nativní ochranu, vrátí stav Chráněný (nativní) nebo Nechráněný.

Příklad 2: Výpis stavu ochrany pro všechny soubory ve složce a všechny podsložky

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

Přestože rutina Get-RMSFileStatus funguje pro jeden soubor najednou, můžete pomocí následujícího příkazu Windows PowerShell získat stav všech souborů ve složce (v našem příkladu s názvem C:\Documents) a jejích podsložek.

Stejný příkaz lze použít s cestou UNC místo jednotky a cesty.

Příklad 3: Vytvoření souboru .CSV se stavem ochrany pro všechny soubory ve složce a všechny podsložky

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

Předchozí příklad můžete dále rozšířit výstupem výsledků do .CSV souboru, abyste mohli informace seřadit a uspořádat.

V tomto příkladu se soubor .CSV jmenuje ProtectedFilesList.csv a uloží se do složky C:\Temp . Pokud už soubor existuje, přepíše se.

Parametry

-File

Určuje plně kvalifikovanou cestu k souboru, která ověří, jestli je chráněna službou Rights Management.

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