Set-AppRetentionCompliancePolicy
Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.
Usare il Set-AppRetentionCompliancePolicy per modificare i criteri di conformità della conservazione delle app.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-RetryDistribution]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-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.
Esempio
Esempio 1
Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,VivaEngage" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"In questo esempio viene aggiunto un nuovo utente al criterio di conservazione dell'ambito statico esistente denominato Regolamento 563 Marketing configurato per i messaggi dei canali privati di Teams.
Parametri
-AddAdaptiveScopeLocation
Il parametro AddAdaptiveScopeLocation specifica il percorso dell'ambito adattivo da aggiungere ai 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
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddExchangeLocation
Il parametro AddExchangeLocation consente di specificare le cassette postali da aggiungere all'elenco delle cassette postali incluse quando non si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Il parametro ExchangeLocation specifica le cassette postali da includere nel criterio. 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddExchangeLocationException
Il parametro AddExchangeLocationException consente di specificare le cassette postali da aggiungere all'elenco delle cassette postali escluse 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddModernGroupLocation
Il parametro AddModernGroupLocation specifica il Gruppi di Microsoft 365 da aggiungere all'elenco dei Gruppi di Microsoft 365 inclusi quando non si usa 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddModernGroupLocationException
Il parametro AddModernGroupLocationException specifica il Gruppi di Microsoft 365 da aggiungere all'elenco di Gruppi di Microsoft 365 esclusi quando si usa 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Applications
Il parametro Applications consente di specificare le applicazioni da includere ed è rilevante solo per i parametri di posizione seguenti:
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
Questo parametro usa la sintassi seguente: "LocationtType:App1,LocationType:App2,...LocationType:AppN dove LocationType è User o Group. Ad esempio, "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" o "User:MicrosoftTeams","User:VivaEngage".
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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-*) 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.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-DeletedResources
{{ Fill DeletedResources Description }}
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Enabled
Il parametro Enabled abilita o disabilita i criteri. I valori validi sono:
- $true: i criteri sono abilitati. Questo è il valore predefinito.
- $true: il criterio è abilitato. Questo è il valore predefinito.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Identity
Il parametro Identity consente di specificare i criteri di conformità per la conservazione delle app che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Tipo: | PolicyIdParameter |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PolicyRBACScopes
Il parametro PolicyRBACScopes consente di specificare le unità amministrative da assegnare ai criteri. Un valore valido è il Microsoft Entra ObjectID (valore GUID) dell'unità amministrativa. È possibile specificare più valori separati da virgole.
Le unità amministrative sono disponibili solo in Microsoft Entra ID P1 o P2. È possibile creare e gestire unità amministrative in Microsoft Graph PowerShell.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveAdaptiveScopeLocation
Il parametro RemoveAdaptiveScopeLocation specifica il percorso dell'ambito adattivo da rimuovere dai 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
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveExchangeLocation
Il parametro RemoveExchangeLocation consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali incluse quando non 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveExchangeLocationException
Il parametro RemoveExchangeLocationException consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali escluse 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveModernGroupLocation
Il parametro RemoveModernGroupLocation consente di specificare il Gruppi di Microsoft 365 da rimuovere dall'elenco dei gruppi inclusi quando non si usa 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveModernGroupLocationException
Il parametro RemoveModernGroupLocationException specifica il Gruppi di Microsoft 365 da rimuovere dall'elenco dei gruppi esclusi quando si usa 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
Dopo che un criterio è stato bloccato, nessuno può disattivarlo o disabilitarlo o rimuovere le app dal criterio. Gli unici modi in cui è possibile modificare i criteri sono l'aggiunta di app o l'estensione della durata. Un criterio bloccato può essere aumentato o esteso, ma non può essere ridotto, disabilitato o disattivato.
Pertanto, prima di bloccare un criterio, è fondamentale comprendere i requisiti di conformità dell'organizzazione e non bloccare un criterio fino a quando non si è certi che sia quello che serve.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RetryDistribution
L'opzione RetryDistribution specifica se ridistribuire i criteri in tutte le posizioni. 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 della 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 il completamento della distribuzione dei criteri prima di eseguire di nuovo il comando per i criteri successivi.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-WhatIf
Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |