New-RetentionCompliancePolicy
Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.
Usare il cmdlet New-RetentionCompliancePolicy per creare nuovi criteri di conservazione e nuovi criteri di etichetta di conservazione nel Portale di conformità di Microsoft Purview. La creazione di un nuovo criterio richiede anche l'uso del cmdlet New-RetentionComplianceRule.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-RetentionCompliancePolicy
[-Name] <String>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-IsSimulation]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-PublicFolderLocation <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-TeamsChannelLocation <MultiValuedProperty>]
[-TeamsChannelLocationException <MultiValuedProperty>]
[-TeamsChatLocation <MultiValuedProperty>]
[-TeamsChatLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
I criteri non sono validi fino a quando non viene aggiunta una regola (per i criteri di conservazione) o un'etichetta (per i criteri delle etichette di conservazione). Per altre informazioni, vedere New-RetentionComplianceRule. Inoltre, è necessario definire almeno un parametro di posizione per creare un criterio di conservazione o un criterio di etichetta di conservazione.
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-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"In questo esempio viene creato un criterio di conservazione denominato "Conformità al regolamento 123" per le cassette postali di Kitty Petersen e Scott Nakamura e il sito di SharePoint Online finance.
Il passaggio successivo consiste nell'usare il cmdlet New-RetentionComplianceRule per aggiungere una regola ai criteri di conservazione.
Esempio 2
New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."In questo esempio viene creato un nuovo criterio di applicazione automatica delle etichette destinato agli allegati cloud denominati Marketing Department con i dettagli specificati.
Il passaggio successivo consiste nell'usare il cmdlet New-RetentionComplianceRule per aggiungere un'etichetta di conservazione ai criteri dell'etichetta di conservazione.
Parametri
-AdaptiveScopeLocation
Il parametro AdaptiveScopeLocation consente di specificare il percorso dell'ambito adattivo da includere nei criteri. È possibile creare ambiti adattivi usando il cmdlet New-AdaptiveScope. È possibile usare qualsiasi valore che identifichi in modo univoco l'ambito adattivo. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
Il parametro Applications specifica la destinazione quando Gruppi di Microsoft 365 sono inclusi nel criterio (il parametro ModernGroups è impostato). I valori validi sono:
Group:Exchangeper la cassetta postale connessa al gruppo di Microsoft 365.Group:SharePointper il sito di SharePoint connesso al gruppo di Microsoft 365."Group:Exchange,SharePoint"sia per la cassetta postale che per il sito di SharePoint connessi al gruppo di Microsoft 365.- blank (
$null): questo è il valore predefinito ed è funzionalmente equivalente al valore"Group:Exchange,SharePoint".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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
- Valore All per tutte le cassette postali. È possibile utilizzare questo valore solo singolarmente.
Il valore All per tutte le cassette postali. È possibile utilizzare questo valore esclusivamente da solo.
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È 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 |
-ExchangeLocationException
Il parametro ExchangeLocationException consente di specificare le cassette postali da escludere dai criteri quando si usa il valore All per il parametro ExchangeLocation. 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
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| 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 |
-IsSimulation
L'opzione IsSimulation specifica che il criterio viene creato in modalità di simulazione. Con questa opzione non è necessario specificare alcun valore.
Per altre informazioni sulla modalità di simulazione, vedere Informazioni sulla modalità di simulazione.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocation
Il parametro ModernGroupLocation consente di specificare il Gruppi di Microsoft 365 da includere nei criteri. I valori validi sono:
- Un gruppo di Microsoft 365
- Valore All per tutti i Gruppi di Microsoft 365. È possibile utilizzare questo valore solo singolarmente.
Per identificare il gruppo di Microsoft 365, è possibile usare qualsiasi valore che lo identifichi in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocationException
Il parametro ModernGroupLocationException specifica il Gruppi di Microsoft 365 da escludere dai criteri quando si utilizza il valore All per il parametro ModernGroupLocation.
È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| 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 il nome univoco del criterio di conservazione. 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 |
-OneDriveLocation
Il parametro OneDriveLocation consente di specificare i siti OneDrive for Business da includere. È possibile identificare il sito mediante il relativo valore URL oppure utilizzare il valore All per includere tutti i siti.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-OneDriveLocationException
Questo parametro specifica i siti OneDrive for Business da escludere quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyTemplateInfo
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 nel criterio di conservazione. 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 |
-RestrictiveRetention
Il parametro RestrictiveRetention consente di specificare se blocco di archiviazione è abilitato per i criteri. I valori validi sono:
- $true: blocco di conservazione abilitato per i criteri. Nessuno, incluso un amministratore, può disattivare i criteri o renderli meno restrittivi.
- $false: blocco di conservazione non è abilitato per i criteri. Questo è il valore predefinito.
Una volta bloccato un criterio, nessun utente può disattivarlo o rimuoverne il contenuto. Non è possibile modificare o eliminare contenuto soggetto ai criteri durante il periodo di conservazione. È possibile modificare i criteri di conservazione solo aggiungendovi dei contenuti o estendendone la durata. Un criterio bloccato può essere aumentato o esteso, ma non può essere ridotto, disabilitato o disattivato.
Pertanto, prima di bloccare un criterio di conservazione, è fondamentale comprendere i requisiti di conformità dell'organizzazione e non bloccare un criterio fino a quando non si è certi che sia quello che serve.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetainCloudAttachment
Nota: questo parametro è attualmente disponibile in anteprima, non è disponibile in tutte le organizzazioni ed è soggetto a modifiche.
Il parametro RetainCloudAttachment specifica che si tratta di un criterio di allegati cloud. I valori validi sono:
- $true: il criterio è un criterio di allegati cloud.
- $false: il criterio non è un criterio di allegati cloud. Questo è il valore predefinito.
Per il valore $true, è possibile usare solo i parametri di posizione seguenti:
- SharePointLocation e SharePointLocationException
- OneDriveLocation e OneDriveLocationException
- ModernGroupLocation e ModernGroupLocationException
Un tag che usa un criterio di allegato cloud per creare una regola può essere un'etichetta record o un'etichetta normativa. Non è possibile usare un tag di pubblicazione per un criterio di allegati cloud per creare una regola. sono supportati solo i tag di applicazione.
Il parametro RetainCloudAttachment non è disponibile nel cmdlet Set-RetentionCompliancePolicy.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Il parametro SharePointLocation consente di specificare i siti di SharePoint Online da includere. È possibile identificare il sito mediante il relativo valore URL oppure utilizzare il valore All per includere tutti i siti.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
I siti di SharePoint Online non possono essere aggiunti ai criteri finché non sono stati indicizzati. Se non viene specificato nessun sito, non viene conservato nessun sito.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationException
Questo parametro specifica i siti di SharePoint Online da escludere quando si utilizza 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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocation
Il parametro SkypeLocation consente di specificare il Skype for Business utenti online da includere nei criteri.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocation
Il parametro TeamsChannelLocation consente di specificare teams da includere nei criteri.
È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocationException
Il parametro TeamsChannelLocationException consente di specificare teams da escludere quando si usa il valore All per il parametro TeamsChannelLocation. È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocation
Il parametro TeamsChatLocation consente di specificare gli utenti di Teams da includere nei criteri.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocationException
Il parametro TeamsChatLocationException consente di specificare gli utenti di Teams da escludere quando si usa il valore All per il parametro TeamsChatLocation. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |