Partilhar via

Set-ScannerContentScan

  • Referência
Módulo:
PurviewInformationProtection

Define as definições para uma tarefa de análise de conteúdos do Proteção de Informações do Microsoft Purview scanner.

Sintaxe

Set-ScannerContentScan
   [-Schedule <Schedule>]
   [-DiscoverInformationTypes <DiscoverInformationTypes>]
   [-RecommendedAsAutomatic <OnOffEnum>]
   [-EnableDlp <OnOffEnum>]
   [-Enforce <OnOffEnum>]
   [-LabelFilesByContent <OnOffEnum>]
   [-RelabelFiles <OnOffEnum>]
   [-AllowLabelDowngrade <OnOffEnum>]
   [-EnforceDefaultLabel <OnOffEnum>]
   [-DefaultLabelType <DefaultLabelType>]
   [-DefaultLabelId <Guid>]
   [-DefaultOwner <String>]
   [-RepositoryOwner <String>]
   [-PreserveFileDetails <OnOffEnum>]
   [-IncludeFileTypes <String>]
   [-ExcludeFileTypes <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Define a configuração da tarefa de análise de conteúdos, que analisa o conteúdo nos repositórios definidos, de acordo com as definições definidas. Para obter mais informações sobre tarefas de análise de conteúdos, veja a documentação do scanner no local Proteção de Informações do Microsoft Purview.

Exemplos

Exemplo 1 Definir as predefinições da tarefa de análise de conteúdo

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off

Este exemplo define a tarefa de análise de conteúdos com predefinições e define a opção Imposição de política como Desativada.

Exemplo 2 Definir uma tarefa básica de análise de conteúdo que é executada continuamente

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off -RelabelFiles On -EnforceDefaultLabel On -Schedule Always

Este exemplo define a tarefa de análise de conteúdos com sem impor uma política, permitindo que os ficheiros sejam etiquetados novamente, utilizando uma etiqueta predefinida, e está agendado para ser sempre executado.

Exemplo 3: definir uma tarefa de análise de conteúdos que permita apenas ações de nova etiquetagem específicas

PS C:\WINDOWS\system32> Set-ScannerContentScan -RelabelFiles On -AllowLabelDowngrade On -EnforceDefaultLabel On

Este exemplo define uma tarefa de análise de conteúdos que permite que os conteúdos sejam etiquetados novamente apenas para mudar para uma etiqueta ou utilizar uma etiqueta predefinida.

Exemplo 4 Definir uma tarefa de análise de conteúdos que exclua ficheiros .msg e .tmp

PS C:\WINDOWS\system32> Set-ScannerContentScan -IncludeFileTypes '' -ExcludeFileTypes '.msg,.tmp'

Este exemplo define uma tarefa de análise de conteúdos que inclui todos os tipos de ficheiro, exceto .msg e ficheiros de .tmp.

Exemplo 5: Definir uma tarefa de análise de conteúdos com o DLP ativado e um proprietário de repositório específico

PS C:\WINDOWS\system32> Set-ScannerContentScan -EnableDLP On -RepositoryOwner 'domain\user'

Este exemplo define a tarefa de análise de conteúdos para utilizar os tipos de informações de confidencialidade de prevenção de perda de dados (DLP) do Microsoft Purview ao analisar os seus conteúdos e também define um proprietário específico para os repositórios da tarefa de análise de conteúdos.

Exemplo 6 Definir uma tarefa de análise de conteúdos com uma etiqueta predefinida a utilizar ao etiquetar automaticamente o conteúdo

PS C:\WINDOWS\system32> Set-ScannerContentScan -DefaultLabelType Custom -DefaultLabelId 'ff1f1c9d-2f92-4a18-3d84-4608b742424'

Este exemplo define a tarefa de análise de conteúdos com uma etiqueta específica utilizada como etiqueta predefinida, especificada pelo ID da etiqueta.

Parâmetros

-AllowLabelDowngrade

Determina se a tarefa de análise de conteúdos permite ações de mudança para uma versão anterior da etiquetagem.

Relevante apenas quando o parâmetro RelabelFiles está definido como ativado.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultLabelId

Define o ID da etiqueta predefinida utilizada ao etiquetar automaticamente conteúdo com uma etiqueta predefinida.

Obrigatório se o parâmetro DefaultLabelType estiver definido como personalizado.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultLabelType

Determina o tipo de etiqueta predefinida utilizada ao etiquetar automaticamente conteúdo com uma etiqueta predefinida.

Quando utilizado, defina o ID de etiqueta que pretende utilizar como ID predefinido com o parâmetro DefaultLabelId .

Tipo:DefaultLabelType
Valores aceites:None, PolicyDefault, Custom
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultOwner

Define o valor de proprietário predefinido utilizado para os ficheiros analisados, utilizando o endereço de e-mail da conta. Por predefinição, esta é a conta do scanner.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DiscoverInformationTypes

Determina os tipos de tipos de informações detetados durante a tarefa de análise de conteúdos.

Tipo:DiscoverInformationTypes
Valores aceites:PolicyOnly, All
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableDlp

Determina se a tarefa de análise de conteúdos utiliza os tipos de informações de confidencialidade de prevenção de perda de dados (DLP) ao analisar os seus conteúdos.

Dica

Se configurar este parâmetro, também poderá querer configurar um proprietário de repositório específico com o parâmetro RepositoryOwner .

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Enforce

Determina se a tarefa de análise de conteúdos impõe a análise de conteúdos e a etiquetagem de acordo com a sua política.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnforceDefaultLabel

Determina se a utilização de uma etiqueta predefinida é sempre utilizada ao atribuir novamente conteúdos.

Relevante apenas quando o parâmetro RelabelFiles está definido como ativado.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExcludeFileTypes

Determina quaisquer tipos de ficheiro que sejam ignorados durante a tarefa de análise de conteúdos. Defina vários tipos de ficheiro com uma lista separada por vírgulas.

Se definir este parâmetro, defina o parâmetro IncludeFileTypes como nulo. Por exemplo, Exemplo 4 acima.

Relevante apenas quando o parâmetro OverrideContentScanJob está definido como ativado nos cmdlets Add-ScannerRepository ou Set-ScannerRepository .

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IncludeFileTypes

Determina explicitamente os tipos de ficheiro que são analisados pela tarefa de análise de conteúdos. Defina vários tipos de ficheiro com uma lista separada por vírgulas.

Se definir este parâmetro, defina o parâmetro ExcludeFileTypes como nulo. Por exemplo, Exemplo 4 acima.

Relevante apenas quando o parâmetro OverrideContentScanJob está definido como ativado nos cmdlets Add-ScannerRepository ou Set-ScannerRepository .

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LabelFilesByContent

Determina se a opção Etiquetar ficheiros com base na tarefa de análise de conteúdos está ativada ou desativada.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PreserveFileDetails

Determina se os detalhes do ficheiro, incluindo a data de modificação, última modificação e modificação pelas definições, são preservados durante a análise e a etiquetagem automática.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RecommendedAsAutomatic

Determina se as etiquetas recomendadas são utilizadas para etiquetar automaticamente o conteúdo.

Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RelabelFiles

Determina se a tarefa de análise de conteúdos tem permissão para voltar a etiquetar ficheiros.

Dica

Ao utilizar este parâmetro, utilize os seguintes parâmetros adicionais, conforme necessário:

  • EnforceDefaultLabel
  • AllowLabelDowngrade
Tipo:OnOffEnum
Valores aceites:On, Off
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RepositoryOwner

Especifica o SAMAccountname (domínio\utilizador), UPN (user@domain) ou SID de um grupo que detém o repositório.

Os proprietários recebem permissões de controlo total no ficheiro se as permissões no ficheiro forem alteradas por uma regra DLP correspondente.

Relevante apenas quando o parâmetro EnableDlp está definido como ativado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Schedule

Determina se a tarefa de análise de conteúdos é executada de acordo com uma agenda específica ou continuamente.

Tipo:Schedule
Valores aceites:Manual, Always
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object