Condividi tramite


New-ManagedContentSettings

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-09-16

Utilizzare il cmdlet New-ManagedContentSettings per creare nuove impostazioni del contenuto gestito per le cartelle gestite.

Sintassi

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le Impostazioni del contenuto gestito sono impostazioni che vengono applicate alle cartelle gestite per controllare l'intervallo di tempo valido per gli elementi nelle cassette postali degli utenti. L'intervallo di tempo valido viene controllato nei modi seguenti:

  • Con il controllo del mantenimento dei contenuti e la rimozione del contenuto non più necessario.

  • Con l'inserimento nel journal automatico del contenuto importante in un percorso di archiviazione diverso al di fuori della cassetta postale.

Per ulteriori informazioni sulle impostazioni del contenuto gestito, vedere Gestione dei record di messaggistica.

Per eseguire il cmdlet New-ManagedContentSettings, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Organization Administrator

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

FolderName

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Il parametro FolderName consente di specificare il nome o il GUID della cartella gestita a cui applicare le Impostazioni del contenuto gestito.

MessageClass

Obbligatorio

System.String

Il parametro MessageClass consente di specificare il tipo di messaggio a cui applicare qualsiasi impostazione di configurazione della scadenza e dell'inserimento nel journal in questo contenuto.

  • Il valore di parametro deve essere una classe di messaggi specifica, come IPM.NOTE.SMIME o una classe di messaggi personalizzata.

I valori validi di parametro per le classi di messaggi personalizzati includono:

  • Una classe di messaggi specifica (ad esempio, IPM.NOTE)

  • Il carattere jolly asterisco (*), che indica che le impostazioni del contenuto si applicano a tutte le classi di messaggi.

  • Una classe di messaggi specifica con il carattere jolly asterisco. Il carattere jolly asterisco deve essere visualizzato come ultimo carattere nella classe di messaggi.

    Esempi:

    • IPM.NOTE* (Include IPM.NOTE e tutte le relative sottoclassi.)

    • IPM.NOTE.* (Include le sottoclassi di IPM.NOTE ma non IPM.NOTE.)

    • *.NOTE e IPM.*.NOTE non sono accettabili.

Nota

Quando vengono utilizzati caratteri jolly, questi criteri si applicano solo alle classi di messaggi senza un'impostazione specifica per il contenuto. Pertanto, IPM.NOTE.SMIME ha la precedenza su IPM.NOTE.*

Nota

Le impostazioni specifiche sostituiscono le impostazioni generali. Ad esempio, Segreteria telefonica sostituisce Tutto il contenuto delle cassette postali.
Nell'elenco seguente sono riportati i tipi di messaggi noti e i valori da utilizzare:

  • Per il tipo di messaggio Tutto il contenuto della cassetta postale, utilizzare il valore *.

  • Per il tipo di messaggio Elementi del Calendario, utilizzare il valore IPM.Appointment*.

  • Per il tipo di messaggio Contatti, utilizzare il valore IPM.Contact*.

  • Per il tipo di messaggio Documenti, utilizzare il valore IPM.Document*.

  • Per il tipo di messaggio Fax, utilizzare il valore IPM.Note.Microsoft.Fax.

  • Per il tipo di messaggio Elementi di Journal, utilizzare il valore IPM.Activity.

  • Per il tipo di messaggio Convocazioni, risposte e annullamenti di riunione, utilizzare il valore IPM.Schedule*.

  • Per il tipo di messaggio Note, utilizzare il valore IPM.StickyNote.

  • Per il tipo di messaggio Inserimenti, utilizzare il valore IPM.Post.

  • Per il tipo di messaggio Elementi RSS, utilizzare il valore IPM.Post.RSS.

  • Per il tipo di messaggio Attività, utilizzare il valore IPM.Task*.

  • Per il tipo di messaggio Sistema di caselle vocali, utilizzare il valore IPM.Note.Microsoft.Voicemail*.

Name

Obbligatorio

System.String

Il parametro Name consente di specificare un nome univoco per le impostazioni del contenuto gestito.

AddressForJournaling

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Il parametro AddressForJournaling consente di specificare l'indirizzo dell'archivio che sarà la destinazione dell'operazione di inserimento nel journal. Se questo parametro non è presente e il parametro JournalingEnabled è impostato su $true, viene restituito un errore.

AgeLimitForRetention

Facoltativo

System.Nullable

Il parametro AgeLimitForRetention consente di specificare la validità del mantenimento applicato a un elemento. Il limite della validità corrisponde al numero di giorni a partire dalla data di recapito dell'elemento o dalla data di creazione di un elemento in caso di mancato recapito. Se questo parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere le informazioni di configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController.

JournalingEnabled

Facoltativo

System.Boolean

Il parametro JournalingEnabled indica che l'inserimento nel journal è abilitato quando è impostato su $true.

LabelForJournaling

Facoltativo

System.String

Il parametro LabelForJournaling consente di specificare un'etichetta allegata a un elemento. Questa etichetta verrà utilizzata dall'archivio di destinazione per determinare il contenuto dell'elemento e applicare il criterio appropriato.

MessageFormatForJournaling

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

Il parametro MessageFormatForJournaling consente all'amministratore di specificare l'inserimento di un elemento nel journal nel formato con estensione MSG di Microsoft Outlook o nel formato MAPI standard di Outlook.

MoveToDestinationFolder

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

Il parametro MoveToDestinationFolder consente di specificare la cartella di destinazione di un'azione di spostamento.

La cartella di destinazione deve essere una cartella personalizzata gestita esistente. In caso contrario, viene restituito un errore. Se il parametro MoveToDestinationFolder non è presente e l'azione di mantenimento è MoveToFolder, viene restituito un errore.

RetentionAction

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

Il parametro RetentionAction consente di specificare una delle seguenti azioni:

  • Segna come Oltre limite di mantenimento

  • Sposta in una cartella personalizzata gestita

  • Sposta nella cartella Posta eliminata

  • Elimina e consenti ripristino

  • Elimina definitivamente

Se questo parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.

RetentionEnabled

Facoltativo

System.Boolean

Il parametro RetentionEnabled consente di specificare che il mantenimento è abilitato quando è impostato su $true.

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Quando per il parametro TemplateInstance viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per creare una copia identica dell'oggetto in un server locale o di destinazione.

TriggerForRetention

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

Questo parametro TriggerForRetention indica la data iniziale che sarà utilizzata come inizio del periodo di mantenimento. Un elemento può raggiungere il limite di mantenimento in uno specifico numero di giorni dopo il recapito dell'elemento o dopo lo spostamento in una cartella specifica.

Il valore corrisponde al bit 0x4 dell'attributo msExchELCFlags in Active Directory. Il flag è impostato su $true se l'elemento scade in base alla data di spostamento e su $false se l'elemento scade in base alla data di recapito. Se questo parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

  

Eccezioni

Eccezioni Descrizione

  

Esempio

Nel primo esempio il comando New-ManagedContentSettings viene utilizzato per creare impostazioni del contenuto gestito della classe di messaggi Calendar e denominate MyCalendarContentSettings. Le impostazioni del contenuto gestito vengono applicate alla cartella predefinita Calendario. Il mantenimento è abilitato e gli elementi vengono spostati nella cartella Posta eliminata dopo 30 giorni.

Nel secondo esempio, stub (di una classe di messaggi personalizzata denominata IPM.Note.Archive.Shortcut) per il contenuto archiviato nella Posta in arrivo di utenti vengono eliminati con l'impostazione del contenuto gestito denominata RemoveArchiveStubs.

Per ulteriori informazioni sulle classi di messaggi personalizzate, vedere la descrizione del parametro "MessageClass" in questo argomento e la sezione "A proposito di classi di messaggio" dell'articolo 241235 della Microsoft Knowledge Base, Come modificare globalmente dei moduli predefiniti in Outlook utilizzando l'utilità Forms Administrator.

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"