New-SensitiveInformationScanRule

Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..

Use o cmdlet New-SensitiveInformationScan para criar regras de verificação de informações confidenciais.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default)

New-SensitiveInformationScanRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    -Workload <PolicyConfiguration.Workload>
    [-Comment <String>]
    [-Confirm]
    [-ContentCreatedOrUpdatedDateFrom <System.DateTime>]
    [-ContentCreatedOrUpdatedDateTo <System.DateTime>]
    [-ContentExtensionMatchesWords <MultiValuedProperty>]
    [-ContentPropertyContainsWords <MultiValuedProperty>]
    [-ExceptIfContentExtensionMatchesWords <MultiValuedProperty>]
    [-ExceptIfContentPropertyContainsWords <MultiValuedProperty>]
    [-StartImpactAssessment <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

New-SensitiveInformationScan "SharePoint scan" -SharePointLocation All

New-SensitiveInformationScanRule "SharePoint scan rule" -ContentExtensionMatchesWords "pdf", "docx" -Policy "SharePoint scan" -Workload SharePoint

Este exemplo cria uma verificação para todos os sites do SharePoint com escopo apenas para arquivos pdf e docx. Use o New-SensitiveInformationScanRule somente em combinação com New-SensitiveInformationScan.

Parâmetros

-Comment

Aplicável: Segurança & Conformidade

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Segurança & Conformidade

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentCreatedOrUpdatedDateFrom

Aplicável: Segurança & Conformidade

O parâmetro ContentCreatedOrUpdatedDateFrom especifica a data/hora de modificação mais antiga dos arquivos considerados no escopo dessa verificação.

Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:

  • Especifique o valor de data/hora em UTC: Por exemplo, "2021-05-06 14:30:00z".
  • Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Propriedades do parâmetro

Tipo:System.DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentCreatedOrUpdatedDateTo

Aplicável: Segurança & Conformidade

O parâmetro ContentCreatedOrUpdatedDateTo especifica a data/hora de modificação mais recente dos arquivos considerados no escopo dessa verificação.

Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:

  • Especifique o valor de data/hora em UTC: Por exemplo, "2021-05-06 14:30:00z".
  • Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.

Propriedades do parâmetro

Tipo:System.DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentExtensionMatchesWords

Aplicável: Segurança & Conformidade

O parâmetro ContentExtensionMatchesWords especifica uma condição para a regra que procura palavras em extensões de arquivo. Você pode especificar várias palavras separadas por vírgulas. Independentemente do tipo de arquivo original, esse predicado corresponde à extensão presente no nome do arquivo.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentPropertyContainsWords

Aplicável: Segurança & Conformidade

O parâmetro ContentPropertyContainsWords especifica uma condição para a regra com base em uma correspondência de propriedade no conteúdo. A regra é aplicada ao conteúdo que apresenta a propriedade especificada.

Esse parâmetro aceita valores no formato: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExceptIfContentExtensionMatchesWords

Aplicável: Segurança & Conformidade

O parâmetro ExceptIfContentExtensionMatchesWords especifica uma exceção para a regra que procura palavras em extensões de arquivo. Você pode especificar várias palavras separadas por vírgulas. Independentemente do tipo de arquivo original, esse predicado corresponde com base na extensão presente no nome do arquivo.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExceptIfContentPropertyContainsWords

Aplicável: Segurança & Conformidade

O parâmetro ExceptIfContentPropertyContainsWords especifica uma exceção para a regra com base em uma correspondência de propriedade no conteúdo. A regra não é aplicada ao conteúdo que contém a propriedade especificada.

Esse parâmetro aceita valores no formato: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Aplicável: Segurança & Conformidade

O parâmetro Name especifica o nome da regra exclusiva para a verificação. Se o valor contiver espaços, coloque-o entre aspas.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Policy

Aplicável: Segurança & Conformidade

O parâmetro Policy especifica o nome da política de verificação pai para essa regra. Se o valor contiver espaços, coloque-o entre aspas.

Propriedades do parâmetro

Tipo:PolicyIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StartImpactAssessment

Aplicável: Segurança & Conformidade

O parâmetro StartImpactAssessment especifica se uma estimativa de verificação deve ser iniciada. Os valores válidos são:

  • $true: Iniciar uma estimativa de varredura por padrão.
  • $false: Impedir o início da estimativa de varredura por padrão.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Segurança & Conformidade

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Workload

Aplicável: Segurança & Conformidade

O parâmetro Workload especifica a carga de trabalho. Os valores válidos são:

  • Aplicativos
  • Alerta de Auditoria
  • AWS
  • Azure
  • AzureBatch
  • Copilot
  • DynamicScope
  • EndpointDevices
  • Exchange
  • ExchangeOnPremises
  • Intune
  • Grupo Moderno
  • OneDriveForBusiness
  • Verificador local
  • PowerBI
  • PublicFolder
  • SharePoint
  • SharePointOnPremises
  • Skype
  • Substrato
  • Teams
  • Aplicativos de terceiros
  • UnifiedAuditAzure

Esse valor aparece na propriedade LogicalWorkload na saída do cmdlet Get-SensitiveInformationScanRule.

Propriedades do parâmetro

Tipo:PolicyConfiguration.Workload
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.