Get-RMSFileStatus
Ruft den RMS-Schutzstatus einer angegebenen Datei ab.
Syntax
Get-RMSFileStatus
-File <String>
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-RMSFileStatus gibt den Schutzstatus (unabhängig davon, ob die Datei durch die Rechteverwaltung geschützt ist) einer angegebenen Datei zurück.
Eine geschützte Datei verfügt über den Status "Protected (Native) oder Protected (Generic)", und eine nicht geschützte Datei hat den Status " Nicht geschützt".
Beachten Sie, dass eine systemeigene geschützte Containerdatei, z. B. eine Outlook-Datendatei (). PST) gibt immer den Schutzstatus von "Unprotected" zurück.
Beispiele
Beispiel 1: Auflisten des Schutzstatus für eine angegebene Datei
PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName Status
-------- ------
C:\Test.docx Unprotected
Dieser Befehl listet den Rights Management-Schutzstatus für die angegebene Datei C:\Test.docxauf.
Da eine Datei mit einer .docx Dateinamenerweiterung nativen Schutz unterstützt, gibt der Status "Protected (Native)" oder "Unprotected" zurück.
Beispiel 2: Auflisten des Schutzstatus für alle Dateien in einem Ordner und unterordnern
PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}
Obwohl das Cmdlet Get-RMSFileStatus gleichzeitig für eine Datei funktioniert, können Sie den folgenden Windows PowerShell Befehl verwenden, um den Status aller Dateien in einem Ordner (in unserem Beispiel "C:\Documents") und dessen Unterordner abzurufen.
Derselbe Befehl kann mit einem UNC-Pfad anstelle eines Laufwerks und Pfads verwendet werden.
Beispiel 3: Erstellen einer .CSV Datei mit dem Schutzstatus für alle Dateien in einem Ordner und unterordnern
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
Sie können das vorherige Beispiel weiter erweitern, indem Sie die Ergebnisse in eine .CSV Datei ausgeben, sodass Sie die Informationen sortieren und sortieren können.
In diesem Beispiel wird die .CSV Datei ProtectedFilesList.csv benannt und im Ordner "C:\Temp " gespeichert. Wenn die Datei bereits vorhanden ist, wird sie überschrieben.
Parameter
-File
Gibt den vollqualifizierten Pfad zur Datei an, um zu überprüfen, ob er durch rechteverwaltung geschützt ist.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |