Set-AIPFileClassification

  • Referência
Módulo:
AzureInformationProtection

Examina um arquivo para definir automaticamente um rótulo de Proteção de Informações do Azure de um arquivo, de acordo com as condições configuradas na política.

Syntax

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Description

O cmdlet Set-AIPFileClassification pode aplicar automaticamente um rótulo para um ou mais arquivos quando você configura rótulos para classificação automática.

Quando esse cmdlet é executado, ele inspeciona o conteúdo do arquivo e se as condições configuradas são atendidas para um rótulo, esse rótulo é aplicado. Essa ação aplicará proteção automaticamente se o rótulo selecionado aplicar proteção.

Por padrão, se o arquivo já tiver um rótulo, o rótulo existente ou a proteção não será substituída.

Quando um arquivo não é rotulado porque foi rotulado manualmente, não houve correspondência para as condições especificadas ou o arquivo teve uma classificação mais alta, o arquivo é ignorado com o único comentário de "Nenhum rótulo a ser aplicado".

Para obter mais informações, consulte: Aplicar um rótulo de confidencialidade ao conteúdo automaticamente

Executando o cmdlet de forma não interativa

Você pode executar esse cmdlet de forma não interativa. Para obter mais informações, consulte o guia de administrador do cliente de rotulagem unificada.

Exemplos

Exemplo 1: verificar todos os arquivos em uma pasta e qualquer uma de suas subpastas, e aplicar os rótulos de acordo com as condições configuradas para a classificação automática

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Esse comando examina todos os arquivos na pasta Projetos e em qualquer uma de suas subpastas e define rótulos de acordo com as condições configuradas na política de rotulagem automática. Neste exemplo, há cinco arquivos e dois arquivos são automaticamente rotulados. O arquivo Datasheet.pdf não é rotulado porque seu conteúdo não corresponde às condições configuradas para classificação automática Analysis.xlsx já foi rotulado manualmente e Pricelist.xlsx tem um rótulo mais alto. Como o comando é executado sem o parâmetro -Force , os rótulos existentes para Analysis.xlsx e Pricelist.xlsx não são substituídos.

Se os rótulos aplicados também forem configurados para aplicar a proteção de Rights Management, os arquivos rotulados com êxito com este comando também serão protegidos. Nesse caso, o proprietário de Rights Management (que tem a permissão Controle Total do Rights Management) desses arquivos será o usuário que executou o comando do PowerShell.

Como o parâmetro PreserveFileDetails é especificado, a data modificada dos arquivos rotulados permanece inalterada.

Exemplo 2: verificar todos os arquivos em uma pasta e qualquer uma de suas subpastas, e aplicar os rótulos de acordo com as condições configuradas para a classificação automática, substituindo qualquer rótulo existente

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Esse comando é semelhante ao exemplo anterior, pois também verifica todos os arquivos na pasta Projetos e em qualquer uma de suas subpastas e define rótulos de acordo com as condições configuradas para rotulagem automática. No entanto, desta vez, como o comando inclui o parâmetro -Force , ele também substitui o rótulo existente para Dashboard.xlsxe Pricelist.xlsx.

O conteúdo de Datasheet.pdf não correspondeu a nenhuma condição configurada e esse arquivo permanece sem um rótulo.

Exemplo 3: (somente cliente de rotulagem unificada) Verifique um arquivo no modo WhatIf para todos os tipos de informações confidenciais conhecidos

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

Esse comando descobre todos os tipos de informações conhecidos em Project1.docx arquivo sem aplicar proteção ou rótulo.

Exemplo 4: (somente cliente de rotulagem unificada) Verifique um arquivo no modo WhatIf para obter tipos de informações confidenciais específicos

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

Este comando descobre os tipos de informações específicos de "Número do Cartão de Crédito" e "Número do Seguro Social (SSN)" no arquivo Project1.docx sem aplicar proteção ou rótulo.

Exemplo 5: (somente cliente de rotulagem unificada) Verifique um arquivo no modo WhatIf para obter tipos de informações confidenciais específicos e exiba os valores encontrados

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

Semelhante ao exemplo anterior, o primeiro comando descobre os tipos de informações específicos de "Número do Cartão de Crédito" e "Número do Seguro Social (SSN)" em Project1.docx arquivo sem aplicar proteção ou rótulo. No entanto, neste exemplo, os resultados são armazenados em uma variável para processamento adicional.

Em seguida, o segundo comando é usado para exibir o conteúdo dos tipos de informações correspondentes, que inclui o parâmetro SensitiveContents.

O comando final exibe e formata para facilitar a leitura dos dados identificados pelo primeiro tipo de informação confidencial, que neste exemplo são os detalhes do cartão de crédito.

Parâmetros

-DiscoveryInfoTypes

Observação: esse parâmetro só tem suporte com o cliente de rotulagem unificada do Azure Proteção de Informações.

Especifique os tipos de informações confidenciais a serem descobertos ao usar o parâmetro WhatIf .

Se você quiser pesquisar tipos de informações confidenciais específicos, especifique o número da ID da entidade para esse tipo de informação, que você pode encontrar listado em tipos de informações confidenciais em Exchange Server.

Por exemplo, "50842eb7-edc8-4019-85dd-5a5c1f2bb085" é o número a ser especificado para o tipo de informações confidenciais número do cartão de crédito.

Type:String[]
Accepted values:All, "rule_id_1", "rule_id_2"
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Substitui um rótulo existente quando as condições configuradas aplicam-se.

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

-JustificationMessage

O motivo de justificativa para reduzir o rótulo de classificação, remover um rótulo ou remover a proteção, se a política de Proteção de Informações do Azure requerer que os usuários forneçam essas informações.

Se a configuração de um rótulo disparar a justificativa e esse motivo não for fornecido, o rótulo não será aplicado, mesmo que o parâmetro -Force esteja definido. Nesse caso, o status retornado é "Ignorado" com o seguinte comentário: "Nenhum rótulo a ser aplicado"

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

-Path

Especifica um caminho local, um caminho de rede ou a URL do SharePoint Server para os arquivos para os quais você deseja obter o rótulo e as informações de proteção.

Não há suporte para curingas e locais de WebDav.

Para caminhos do SharePoint, há suporte para o seguinte:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Por exemplo:

Os caminhos podem incluir espaços quando você coloca entre aspas o valor do caminho.

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PreserveFileDetails

Especifique esse parâmetro para deixar a data inalterada para documentos que você rotula.

Para arquivos locais ou de rede, a data da Última Modificação permanece inalterada.

Para arquivos do SharePoint, a data modificada e a data modificada por data permanecem inalteradas.

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

-WhatIf

Relevante para: Somente cliente de rotulagem unificada

Mostra o que aconteceria se o cmdlet fosse executado e fosse o equivalente ao modo de descoberta do verificador. As alterações não serão aplicadas em arquivos de entrada ou saída.

Use esse parâmetro com DiscoveryInfoTypes para procurar todos os tipos de informações confidenciais ou tipos de informações confidenciais específicos.

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

Entradas

System.String[]

Saídas

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult