Get-AIPFileStatus
Obtém a etiqueta Information Protection Azure e informações de proteção para um ficheiro ou ficheiros especificados.
Syntax
Get-AIPFileStatus
[-Path] <String[]>
[<CommonParameters>]
Description
O cmdlet Get-AIPFileStatus devolve o estado de Information Protection do Azure de um ficheiro especificado ou de todos os ficheiros num caminho especificado. Este estado inclui se o ficheiro tem uma etiqueta, e se o faz, o nome do rótulo, quem o aplicou, como foi aplicado, e quando.
Se os seus ficheiros forem armazenados no SharePoint Online, utilize o cmdlet Get-FileSensitivityLabelInfo do módulo SharePointOnlinePowerShell .
O estatuto devolvido no cmdlet Get-AIPFileStatus também inclui se o ficheiro está protegido pela Gestão de Direitos, e se for, qual o modelo de Gestão de Direitos usado para aplicar esta proteção. Se o ficheiro foi protegido com permissões personalizadas (uma política de direitos ad-hoc) em vez de um modelo, "Acesso Restrito" é exibido em vez do nome do modelo. Além disso, é apresentado o emitente de Gestão de Direitos e Gestão de Direitos e quando o ficheiro foi protegido.
Este cmdlet devolve apenas informações de etiqueta do seu próprio inquilino.
Note que os ficheiros protegidos por palavra-passe devolvem sempre o estado de proteção do Falso.
Pode executar este cmdlet não interativo. Para mais informações, consulte o guia de administração do cliente de rotulagem Unificada.
Exemplos
Exemplo 1: Obtenha o rótulo e o estado de proteção de um único ficheiro
PS C:\> Get-AIPFileStatus -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
Este comando fornece informações sobre um ficheiro que é rotulado como "Grupo Confidencial \ Finanças", que é um rótulo configurado para o seu inquilino. Este ficheiro foi rotulado manualmente por John e também está protegido através do modelo de Gestão de Direitos, "Contoso - Finanças Confidenciais".
Exemplo 2: Obtenha o rótulo e o estado de proteção de todos os ficheiros numa pasta e exporte os resultados para um ficheiro CSV
PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv
Este comando obtém a etiqueta e informação de proteção de todos os ficheiros do servidor Finance, na pasta Projetos e em qualquer uma das suas sub-dobradeiras. Os resultados são exportados para o ficheiro nomeado AIP-status.csv para que possam ser mais facilmente pesquisados e classificados. Se existir um relatório anterior em C:\Reports\Report.csv, será substituído.
Exemplo 3: Listar os ficheiros rotulados "Confidencial" e exportar os resultados para um ficheiro CSV
PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv
Este comando obtém a etiqueta e informações de proteção apenas para os ficheiros que são rotulados como "Confidencial" (independentemente do seu subliber) no servidor Finanças, na pasta Projetos e em qualquer uma das suas sub-dobradeiras. Os resultados são exportados para o ficheiro nomeado AIP-status.csv para que possam ser mais facilmente pesquisados e classificados. Se existir um relatório anterior em C:\Reports\Report.csv, será substituído.
Exemplo 4: Contagem de ficheiros com uma etiqueta "Confidencial"
PS C:\> (Get-AIPFileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count
5
Este comando fornece o número de ficheiros com a etiqueta "Confidencial" que se encontram na pasta C:\Projetos e em qualquer uma das suas sub-dobradeiras. Neste exemplo, são encontrados 5 ficheiros.
Parâmetros
-Path
Especifica um caminho local, caminho de rede ou URL do Servidor SharePoint para os ficheiros para os quais deseja obter as informações de etiqueta e proteção. Não são suportados carateres universais.
Para os caminhos sharePoint, os seguintes são suportados:
- SharePoint Server 2019
- SharePoint Server 2016
- SharePoint Server 2013
Por exemplo:
- C:\Pasta\
- C:\Pasta\Nome de arquivo
- \\Servidor\Pasta
- http://sharepoint.contoso.com/Shared%20Documents/Folder
Os caminhos podem incluir espaços quando se encerra o valor do caminho com aspas.
Type: | String[] |
Aliases: | FullName, FileName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
System.String[]
Saídas
Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult