New-SensitiveInformationScanRule

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.

Usare il cmdlet New-SensitiveInformationScan per creare regole di analisi delle informazioni riservate.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita) 

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>]

Descrizione

Per usare questo cmdlet in PowerShell per sicurezza e conformità, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

New-SensitiveInformationScan "SharePoint scan" -SharePointLocation All

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

In questo esempio viene creata un'analisi per tutti i siti di SharePoint che hanno come ambito solo i file PDF e DOCX. Usare il New-SensitiveInformationScanRule solo in combinazione con New-SensitiveInformationScan.

Parametri

-Comment

Applicabile: Sicurezza & conformità

Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Sicurezza & conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ContentCreatedOrUpdatedDateFrom

Applicabile: Sicurezza & conformità

Il parametro ContentCreatedOrUpdatedDateFrom specifica la data-ora della prima modifica dei file considerati nell'ambito di questa analisi.

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in UTC: Ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in UTC: Ad esempio, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.

Proprietà dei parametri

Tipo:System.DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ContentCreatedOrUpdatedDateTo

Applicabile: Sicurezza & conformità

Il parametro ContentCreatedOrUpdatedDateTo consente di specificare la data e l'ora dell'ultima modifica dei file considerati nell'ambito di questa analisi.

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in UTC: Ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in UTC: Ad esempio, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.

Proprietà dei parametri

Tipo:System.DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ContentExtensionMatchesWords

Applicabile: Sicurezza & conformità

Il parametro ContentExtensionMatchesWords consente di specificare una condizione per la regola che consente di cercare le parole nelle estensioni di file. È possibile specificare più regole separate da virgole. Indipendentemente dal tipo di file originale, questo predicato cerca le corrispondenze in base all'estensione presente nel nome del file.

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ContentPropertyContainsWords

Applicabile: Sicurezza & conformità

Il parametro ContentPropertyContainsWords specifica una condizione per la regola basata su una corrispondenza di proprietà nel contenuto. La regola viene applicata al contenuto che presenta la proprietà specificata.

Questo parametro accetta valori nel formato seguente: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN".

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExceptIfContentExtensionMatchesWords

Applicabile: Sicurezza & conformità

Il parametro ExceptIfContentExtensionMatchesWords specifica un'eccezione per la regola di ricerca delle parole nelle estensioni di file. È possibile specificare più regole separate da virgole. Indipendentemente dal tipo di file originale, questo predicato cerca le corrispondenze in base all'estensione presente nel nome del file.

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExceptIfContentPropertyContainsWords

Applicabile: Sicurezza & conformità

Il parametro ExceptIfContentPropertyContainsWords specifica un'eccezione per la regola basata su una corrispondenza di proprietà nel contenuto. La regola non viene applicata al contenuto che presenta la proprietà specificata.

Questo parametro accetta valori nel formato seguente: "Property1:Value1,Value2","Property2:Value3,Value4",..."PropertyN:ValueN,ValueN".

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Applicabile: Sicurezza & conformità

Il parametro Nome specifica il nome univoco della regola per l'analisi. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Policy

Applicabile: Sicurezza & conformità

Il parametro Policy consente di specificare il nome del criterio di analisi padre per questa regola. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Proprietà dei parametri

Tipo:PolicyIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StartImpactAssessment

Applicabile: Sicurezza & conformità

Il parametro StartImpactAssessment consente di specificare se avviare una stima dell'analisi. I valori validi sono:

  • $true: per impostazione predefinita, avvia una stima dell'analisi.
  • $false: impedisce l'avvio della stima dell'analisi per impostazione predefinita.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Sicurezza & conformità

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Workload

Applicabile: Sicurezza & conformità

Il parametro Workload consente di specificare il carico di lavoro. I valori validi sono:

  • Applicazioni
  • AuditAlerting
  • AWS
  • Azure
  • AzureBatch
  • Copilot
  • DynamicScope
  • EndpointDevices
  • Exchange
  • ExchangeOnPremises
  • Intune
  • Gruppo moderno
  • OneDriveForBusiness
  • OnPremisesScanner
  • PowerBI
  • PublicFolder
  • SharePoint
  • SharePointOnPremises
  • Skype
  • Substrato
  • Teams
  • App di terze parti
  • UnifiedAuditAzure

Questo valore viene visualizzato nella proprietà LogicalWorkload nell'output del cmdlet Get-SensitiveInformationScanRule.

Proprietà dei parametri

Tipo:PolicyConfiguration.Workload
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.