Get-FileStatus

Get-FileStatus
    [-Path] <String[]>
    [<CommonParameters>]

De cmdlet Get-FileStatus retourneert de status van een opgegeven bestand of van alle bestanden in een opgegeven pad. Deze status omvat of het bestand een label heeft, en zo ja, de labelnaam, wie het heeft toegepast, hoe het is toegepast en wanneer.

Als uw bestanden zijn opgeslagen in SharePoint Online, gebruikt u in plaats daarvan de cmdlet Get-FileSensitivityLabelInfo uit de SharePointOnlinePowerShell-module .

De status die wordt geretourneerd in de cmdlet Get-FileStatus omvat ook of het bestand is beveiligd door Rights Management en zo ja, welke Rights Management-sjabloon is gebruikt om deze beveiliging toe te passen. Als het bestand is beveiligd met aangepaste machtigingen (een ad-hocrechtenbeleid) in plaats van een sjabloon, wordt 'Beperkte toegang' weergegeven in plaats van de sjabloonnaam. Daarnaast worden de eigenaar van Rights Management en de uitgever van Rights Management weergegeven, en wanneer het bestand is beveiligd.

Deze cmdlet retourneert alleen labelgegevens van uw eigen tenant.

Houd er rekening mee dat bestanden die met een wachtwoord zijn beveiligd, altijd de beveiligingsstatus False hebben.

U kunt deze cmdlet niet interactief uitvoeren.

PS C:\> Get-FileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

Deze opdracht bevat informatie over een bestand dat is gelabeld als 'Confidential \ Finance group', een label dat is geconfigureerd voor uw tenant. Dit bestand is handmatig gelabeld door John en wordt ook beveiligd met behulp van de Rights Management-sjabloon 'Contoso - Confidential Finance'.

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

Met deze opdracht worden het label en de beveiligingsgegevens opgehaald van alle bestanden op de financiële server, in de map Projecten en in een van de submappen. De resultaten worden geëxporteerd naar het bestand met de naam Report.csv , zodat ze gemakkelijker kunnen worden doorzocht en gesorteerd. Als er een eerder rapport bestaat in C:\Reports\Report.csv, wordt dit overschreven.

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

Met deze opdracht worden alleen het label en de beveiligingsgegevens opgehaald voor de bestanden met het label 'Vertrouwelijk' (ongeacht het sublabel) op de financiële server, in de map Projecten en in een van de submappen. De resultaten worden geëxporteerd naar het bestand met de naam Report.csv , zodat ze gemakkelijker kunnen worden doorzocht en gesorteerd. Als er een eerder rapport bestaat in C:\Reports\Report.csv, wordt dit overschreven.

PS C:\> (Get-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Met deze opdracht geeft u het aantal bestanden met het label 'Vertrouwelijk' op dat zich in de map C:\Projects en een van de submappen bevindt. In dit voorbeeld worden 5 bestanden gevonden.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.