Set-RetentionPolicy
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.
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
Default (Impostazione predefinita)
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. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 è posizionale, il che significa che puoi usarlo senza l'etichetta -Identity nella posizione supportata nel comando (in questo caso, per primo). Per ulteriori informazioni sui parametri posizionali, vedere Informazioni sui parametri.
Parametri
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali
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 |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Force
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'interruttore di forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Utilizzare questa opzione per nascondere la richiesta di conferma quando si utilizza il parametro RetentionId.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali
Il parametro Identity consente di specificare il nome, il nome distinto (DN) o il GUID dei criteri di conservazione.
Proprietà dei parametri
| Tipo: | MailboxPolicyIdParameter |
| 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 |
-IsDefault
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione IsDefault specifica che questi criteri di conservazione sono i criteri di conservazione predefiniti. Con questa opzione non è necessario specificare alcun valore.
Quando si usa questa opzione, viene visualizzato un avviso che indica che i criteri di conservazione sostituiscono i criteri di conservazione predefiniti correnti (i criteri in cui il valore della proprietà IsDefault è attualmente True) come impostazione predefinita. Per impostazione predefinita, il criterio di conservazione predefinito è denominato Criterio MRM predefinito.
Nota: la modifica dei criteri di conservazione predefiniti potrebbe influire o meno sulle cassette postali nuove ed esistenti in base al valore del parametro RetentionPolicy in tutti i piani delle cassette postali:
- $null (vuoto): le modifiche per le quali i criteri di conservazione sono l'impostazione predefinita si riflettono continuamente nelle cassette postali nuove ed esistenti.
- È specificato un criterio di conservazione: Il valore del parametro RetentionPolicy per tutti i piani delle cassette postali deve essere $null (vuoto) o corrispondere al criterio di conservazione di Exchange configurato come criterio predefinito per l'organizzazione. In caso contrario, l'esperienza potrebbe non essere coerente durante la creazione di nuove cassette postali, l'abilitazione di cassette postali disabilitate e la modifica delle licenze. Per ulteriori informazioni, vedere Piani delle cassette postali in Exchange Online.
Se a una cassetta postale viene assegnato un criterio di conservazione di Exchange diverso dal criterio predefinito, il valore RetentionPolicy della cassetta postale viene sovrascritto quando si modificano le licenze. È necessario reimpostare manualmente il valore originale di RetentionPolicy.
Le modifiche ai criteri di conservazione predefiniti che interessano le cassette postali esistenti possono potenzialmente saturare la rete se sono presenti centinaia o migliaia di cassette postali da aggiornare.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IsDefaultArbitrationMailbox
Applicabile: Exchange Online
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 arbitraggio nell'organizzazione di Exchange Online. Con questa opzione non è necessario specificare alcun valore.
Questo parametro non è disponibile per le distribuzioni locali.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-Name
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro Name consente di specificare un unico nome per i criteri di conservazione.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-RetentionId
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro RetentionId consente di specificare l'identità dei criteri di conservazione per assicurarsi che alle cassette postali spostate tra due organizzazioni di Exchange vengano applicati gli stessi criteri di conservazione. Ad esempio, in una distribuzione tra foreste o in una distribuzione tra locali, 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 alla cassetta postale vengano applicati gli stessi criteri di conservazione.
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.
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-RetentionPolicyTagLinks
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Proprietà dei parametri
| Tipo: | RetentionPolicyTagIdParameter[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-WhatIf
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
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.
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.