New-RetentionPolicy
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
Utilizzare il cmdlet New-RetentionPolicy per creare un criterio di conservazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
New-RetentionPolicy
[-Name] <String>
[-Confirm]
[-DomainController <Fqdn>]
[-IsDefault]
[-IsDefaultArbitrationMailbox]
[-RetentionId <Guid>]
[-RetentionPolicyTagLinks <RetentionPolicyTagIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Descrizione
I tag dei criteri di conservazione sono associati a un criterio di conservazione. Quando a una cassetta postale viene applicato un criterio di conservazione, i tag associati al criterio sono disponibili per l'utente della cassetta postale.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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
New-RetentionPolicy "Business General"
Con questo esempio viene creato il criterio di conservazione Business General senza associazione di tag dei criteri di conservazione.
Esempio 2
New-RetentionPolicy "Business General" -RetentionPolicyTagLinks "General Business","Legal"
Con questo esempio viene creato il criterio di conservazione Business General e viene utilizzato il parametro RetentionPolicyTagLinks per associare due tag dei criteri di conservazione a questo criterio. È possibile immettere più tag dei criteri di conservazione, separati da virgole. Se un nome di tag include uno spazio, racchiudere il nome tra virgolette.
Anche il secondo tag di conservazione, denominato Legal, è racchiuso tra virgolette per ragioni di coerenza. I valori che non includono uno spazio possono essere racchiusi tra virgolette senza modifiche all'interpretazione del comando.
Parametri
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
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
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 |
-IsDefault
Applicabile: Exchange Online
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 sostituisce 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 viene sovrascritto quando si modificano le licenze. È necessario reimpostare manualmente RetentionPolicy 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.
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 arbitrato nell'organizzazione Exchange Online. Con questa opzione non è necessario specificare alcun valore.
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 Online
Il parametro Name consente di specificare il nome del criterio.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| 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 Online
Il parametro RetentionId consente di specificare l'identità dei criteri di conservazione per garantire che le cassette postali spostate da una distribuzione di Exchange locale al cloud continuino ad avere gli stessi criteri di conservazione applicati. Il parametro RetentionId è utilizzato nelle distribuzioni tra sedi diverse. Non è necessario specificare questo parametro nelle distribuzioni esclusivamente locali.
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 Online
Il parametro RetentionPolicyTagLinks consente di specificare i nomi dei tag dei criteri di conservazione da associare a questo criterio.
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 Online
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.
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.