New-CaseHoldRule

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Security & Compliance

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

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

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 Security & Compliance PowerShell, è 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

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".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Confirm

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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ContentMatchQuery

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Disabled

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 è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Policy

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
Type:PolicyIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance