Set-CaseHoldPolicy
Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.
Usare il cmdlet Set-CaseHoldPolicy per modificare i criteri di conservazione delle maiuscole/minuscole esistenti nel Portale di conformità di Microsoft Purview.
Nota: l'esecuzione di questo cmdlet causa una sincronizzazione completa nell'organizzazione, che è un'operazione significativa. Se è necessario aggiornare più criteri, attendere che la distribuzione dei criteri abbia esito positivo prima di eseguire di nuovo il cmdlet per il criterio successivo. Se è necessario aggiornare un criterio più volte, apportare tutte le modifiche in una singola chiamata del cmdlet. Per informazioni sullo stato della distribuzione, vedere Get-CaseHoldPolicy.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
RetryDistribution
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Identity
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-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.
Nota: non usare un comando piped Foreach-Object quando si aggiungono o rimuovono le posizioni degli ambiti: "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.
Esempio
Esempio 1
Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"
In questo esempio vengono apportate le seguenti modifiche al criterio di blocco del caso esistente denominato "Conformità alla normativa 123":
- Aggiunge la cassetta postale per l'utente Kitty Petersen.
- Aggiunge il sito
https://contoso.sharepoint.com/sites/teams/financedi SharePoint. - Elimina le cartelle pubbliche.
- Aggiorna il commento.
Parametri
-AddExchangeLocation
Applicabile: Sicurezza & conformità
Il parametro AddExchangeLocation consente di specificare le cassette postali da aggiungere all'elenco delle cassette postali incluse. 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, far precedere l'indirizzo da un punto (.).
- Microsoft Entra ObjectId. 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AddPublicFolderLocation
Applicabile: Sicurezza & conformità
Il parametro AddPublicFolderLocation consente di specificare che si desidera aggiungere tutte le cartelle pubbliche al criterio di blocco del caso. Si utilizza il valore All per questo parametro.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AddSharePointLocation
Applicabile: Sicurezza & conformità
Il parametro AddSharePointLocation consente di specificare i siti di SharePoint da aggiungere all'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Non è possibile aggiungere siti di SharePoint ai criteri finché non vengono indicizzati.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-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
Identity
| 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 |
-Enabled
Applicabile: Sicurezza & conformità
Il parametro Enabled consente di specificare se il criterio è abilitato. I valori validi sono:
- $true: Il criterio è abilitato. Questo è il valore predefinito.
- $true: il criterio è abilitato. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Applicabile: Sicurezza & conformità
L'interruttore di 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Sicurezza & conformità
Il parametro Identity consente di specificare il criterio di blocco del caso da modificare. È 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: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-RemoveExchangeLocation
Applicabile: Sicurezza & conformità
Il parametro RemoveExchangeLocation consente di specificare le cassette postali esistenti da rimuovere dal criterio. I valori validi sono:
- Questo parametro specifica le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si utilizza il valore All per il ExchangeLocation parametro. I valori validi sono:
- Una cassetta postale
Il valore All per tutte le cassette postali. È possibile utilizzare questo valore esclusivamente da solo.
- Nome
- Indirizzo SMTP. Per specificare una cassetta postale inattiva, far precedere l'indirizzo da un punto (.).
- Microsoft Entra ObjectId. 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RemovePublicFolderLocation
Applicabile: Sicurezza & conformità
Il parametro RemovePublicFolderLocation consente di specificare che si desidera rimuovere tutte le cartelle pubbliche dal criterio di blocco del caso. Si utilizza il valore All per questo parametro.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RemoveSharePointLocation
Applicabile: Sicurezza & conformità
Il parametro RemoveSharePointLocation consente di specificare i siti di SharePoint da rimuovere dall'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RetryDistribution
Applicabile: Sicurezza & conformità
L'opzione RetryDistribution consente di specificare se ridistribuire i criteri in tutte le posizioni di Exchange Online e SharePoint. Con questa opzione non è necessario specificare alcun valore.
I percorsi le cui distribuzioni iniziali hanno avuto esito positivo non sono inclusi nel tentativo. Quando si utilizza questa opzione, vengono segnalati gli errori di distribuzione dei criteri.
Nota: poiché il processo di ripetizione dei tentativi di distribuzione è un'operazione significativa, eseguirlo solo se necessario e per un criterio alla volta. Non è progettato per essere eseguito ogni volta che si aggiorna un criterio. Se si esegue uno script per aggiornare più criteri, attendere che la distribuzione dei criteri abbia esito positivo prima di eseguire nuovamente il comando per il criterio successivo.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RetryDistribution
| 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: 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 |
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.