Condividi tramite

New-CaseHoldRule

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-CaseHoldRule per creare nuove regole di blocco maiuscole e minuscole nel Portale di conformità di Microsoft Purview.

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

Sintassi

Default (impostazione predefinita). 

New-CaseHoldRule
    [-Name] <String>
    -Policy <PolicyIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-ContentMatchQuery <String>]
    [-Disabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

È necessario aggiungere la regola di blocco del caso a un criterio di blocco del caso esistente mediante il parametro Policy. È possibile aggiungere solo una regola a ogni criterio di blocco del caso.

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-CaseHoldRule -Name "2016 Budget Spreadsheets" -Policy "Internal Company Policy" -ContentMatchQuery "filename:2016 budget filetype:xlsx"

In questo esempio viene creata una nuova regola di blocco del caso denominata Fogli di calcolo budget 2016 e viene aggiunta al criterio di blocco del caso esistente denominato "Politiche aziendali interne". La regola si applica ai fogli di lavoro di Excel che contengono la frase budget 2016, ad esempio "budget 2016 planning.xlsx" e "review.xlsx budget 2016"

Esempio 2

New-CaseHoldRule -Name "Contoso Case 07172018 Hold 1" -Policy "Contoso Case 07172018" -ContentMatchQuery "received:12/01/2017..12/31/2018"

In questo esempio i messaggi di posta elettronica ricevuti dai destinatari tra il 1° dicembre 2018 e il 31 dicembre 2018 vengono sospesi.

Parametri

-Comment

Applicabile: Conformità & sicurezza

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: Conformità & sicurezza

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente 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

-ContentMatchQuery

Applicabile: Conformità & sicurezza

Il parametro ContentMatchQuery consente di specificare un filtro di ricerca dei contenuti. Usare questo parametro per creare un blocco basato su query in modo che venga bloccato solo il contenuto corrispondente alla query di ricerca specificata.

Questo parametro utilizza una stringa di ricerca di testo o una query formattata tramite il linguaggio KQL (Keyword Query Language). Per altre informazioni, vedere Informazioni di riferimento sulla sintassi KQL (Keyword Query Language) e Query con parole chiave e condizioni di ricerca per eDiscovery.

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

-Disabled

Applicabile: Conformità & sicurezza

Il parametro Disabled consente di specificare se la regola di blocco del caso è abilitata o disabilitata. I valori validi sono:

  • $true: la regola è disabilitata.
  • $false: la regola è abilitata. Questo valore è il valore predefinito.

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

-Name

Applicabile: Conformità & sicurezza

Il parametro Name consente di specificare un nome univoco per la regola di blocco del caso. 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:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Policy

Applicabile: Conformità & sicurezza

Il parametro Policy consente di specificare i criteri di blocco maiuscole e minuscole che contengono la regola. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

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

-WhatIf

Applicabile: Conformità & sicurezza

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

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.