Set-RetentionPolicy
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet Set-RetentionPolicy per modificare le proprietà dei criteri di conservazione esistenti.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-RetentionPolicy
[-Identity] <MailboxPolicyIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IsDefault]
[-IsDefaultArbitrationMailbox]
[-Name <String>]
[-RetentionId <Guid>]
[-RetentionPolicyTagLinks <RetentionPolicyTagIdParameter[]>]
[-WhatIf]
[<CommonParameters>] Descrizione
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Set-RetentionPolicy "MyPolicy" -RetentionPolicyTagLinks "MyRetentionPolicyTag"Questo esempio modifica i criteri MyPolicy per collegare il tag dei criteri di conservazione MyRetentionPolicyTag con esso.
Il parametro Identity è un parametro posizionale. I parametri posizionali possono essere utilizzati senza l'etichetta (Identity). Per altre informazioni sui parametri posizionazionali, vedere Informazioni sui parametri.
Parametri
-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: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Usare questa opzione per nascondere la richiesta di conferma quando si usa il parametro RetentionId.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Il parametro Identity consente di specificare il nome, il nome distinto (DN) o il GUID dei criteri di conservazione.
| Type: | MailboxPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IsDefault
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione IsDefault specifica che questo criterio di conservazione è il criterio di conservazione predefinito. Con questa opzione non è necessario specificare alcun valore.
Quando si usa questa opzione, viene visualizzato un avviso che informa che questo criterio di conservazione sostituirà il criterio di conservazione predefinito corrente (il criterio in cui il valore della proprietà IsDefault è attualmente True) come valore predefinito. Per impostazione predefinita, i criteri di conservazione predefiniti sono denominati Criteri MRM predefiniti.
Nota: la modifica dei criteri di conservazione predefiniti potrebbe o meno influire sulle cassette postali nuove ed esistenti in base al valore del parametro RetentionPolicy in tutti i piani delle cassette postali:
- $null (vuoto): le modifiche ai criteri di conservazione predefinite vengono continuamente riflesse nelle cassette postali nuove ed esistenti.
- Viene specificato un criterio di conservazione: il valore del parametro RetentionPolicy per tutti i piani delle cassette postali deve essere $null (vuoto) o corrispondere ai criteri di conservazione di Exchange configurati come criteri predefiniti per l'organizzazione. In caso contrario, l'esperienza potrebbe essere incoerente quando si creano nuove cassette postali, si abilitano le cassette postali disabilitate e si modificano le licenze. Per altre informazioni, vedere Piani cassetta postale in Exchange Online.
Se a una cassetta postale viene assegnato un criterio di conservazione di Exchange che non è il criterio predefinito, il valore RetentionPolicy della cassetta postale verrà sovrascritto quando si modificano le licenze e dovrà essere reimpostato manualmente sul valore originale.
Le modifiche ai criteri di conservazione predefiniti che influiscono sulle cassette postali esistenti possono saturare la rete se sono presenti centinaia o migliaia di cassette postali che richiedono aggiornamenti.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsDefaultArbitrationMailbox
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione IsDefaultArbitrationMailbox configura questo criterio come criterio di conservazione predefinito per le cassette postali di arbitrato nell'organizzazione Exchange Online. Con questa opzione non è necessario specificare alcun valore.
Questo parametro non è disponibile per le distribuzioni locali.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Il parametro Name consente di specificare un unico nome per i criteri di conservazione.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetentionId
Il parametro RetentionId specifica l'identità dei criteri di conservazione per assicurarsi che le cassette postali spostate tra due organizzazioni di Exchange continuino a avere gli stessi criteri di conservazione applicati. Ad esempio, in una distribuzione tra foreste o in una distribuzione cross-premise, quando una cassetta postale viene spostata da un server Exchange locale al cloud o una cassetta postale basata sul cloud viene spostata in un server Exchange locale, questo parametro viene usato per assicurarsi che lo stesso criterio di conservazione venga applicato alla cassetta postale.
Di solito non è necessario specificare o modificare il parametro RetentionId per un tag di conservazione. Il parametro viene popolato automaticamente quando si importano i tag di conservazione utilizzando lo script Import-RetentionTags.ps1.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetentionPolicyTagLinks
Il parametro RetentionPolicyTagLinks consente di specificare l'identità dei tag dei criteri di conservazione da associare ai criteri di conservazione. Le cassette postali a cui sono assegnati i criteri di conservazione dispongono di tag di conservazione collegati con tali criteri di conservazione.
| Type: | RetentionPolicyTagIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per