New-CaseHoldPolicy

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-CaseHoldPolicy per creare nuovi criteri di blocco maiuscole/minuscole nel Portale di conformità di Microsoft Purview.

Dopo aver utilizzato il cmdlet New-CaseHoldPolicy per creare dei criteri di blocco del caso, è necessario usare il cmdlet New-CaseHoldRule per creare una regola di blocco del caso e assegnarla ai criteri. Se non si crea una regola per i criteri, il blocco non viene creato e non viene abilitato per i percorsi dei contenuti.

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

Sintassi

New-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

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-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

In questo esempio viene creato un criterio di blocco dei casi denominato "Conformità al regolamento 123" per le cassette postali di Kitty Petersen e Scott Nakamura e il sito di SharePoint Online finanziario per il caso di eDiscovery denominato "123 Compliance Case".

Tenere presente che, dopo aver creato i criteri, è necessario creare una regola ad essi relativa utilizzando il cmdlet New-CaseHoldRule.

Parametri

-Case

Il parametro Case consente di specificare il caso di eDiscovery che si desidera associare ai criteri di blocco del caso. È possibile utilizzare i seguenti valori per identificare il caso di eDiscovery:

Nome
(Valore GUID) di identità.

È possibile trovare questi valori eseguendo il comando: Get-ComplianceCase | Format-Table -Auto Name,Status,Identity.

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

-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

-Enabled

Il parametro Enabled consente di specificare se il criterio è abilitato o disabilitato. I valori validi sono:

$true: i criteri sono abilitati. Questo è il valore predefinito.
$true: il criterio è abilitato. 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

-ExchangeLocation

Il parametro ExchangeLocation consente di specificare le cassette postali da includere nei criteri. I valori validi sono:

Il parametro ExchangeLocation specifica le cassette postali da includere nel criterio. I valori validi sono:
Una cassetta postale

Per specificare una cassetta postale o un gruppo di distribuzione, è possibile usare i valori seguenti:

Nome
Indirizzo SMTP. Per specificare una cassetta postale inattiva, anteporre all'indirizzo un punto (.).
ObjectId di Azure AD. Usare i cmdlet Get-MgUser o Get-MgGroup in Microsoft Graph PowerShell per trovare questo valore.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Se non viene specificata nessuna cassetta postale, non viene conservata nessuna cassetta postale.

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

-Force

L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.

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

-Name

Il parametro Name specifica il nome univoco dei criteri 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

-PublicFolderLocation

Il parametro PublicFolderLocation consente di specificare che si desidera includere tutte le cartelle pubbliche nei criteri di blocco del caso. Si utilizza il valore All per questo parametro.

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

-SharePointLocation

Il parametro SharePointLocation specifica i siti di SharePoint Online e OneDrive for Business da includere. Si identifica un sito in base al relativo valore URL.