New-ManagedContentSettings

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2010

Questo cmdlet è disponibile solo in Exchange Server 2010.

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

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Le Impostazioni del contenuto gestito sono impostazioni che vengono associate 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 altre informazioni sulle impostazioni del contenuto gestito, vedere Gestione dei record di messaggistica.

È 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

New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

In questo esempio vengono create le impostazioni del contenuto gestito per la cartella gestita predefinita Exec-DeletedItems. Quando vengono aggiunti a un criterio cassetta postale della cartella gestita e applicati a una cassetta postale, gli elementi nella cartella Posta eliminata vengono definitivamente eliminati dopo 30 giorni dalla data di consegna.

Esempio 2

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180

In questo esempio vengono create le impostazioni del contenuto gestito CS-Exec-Calendar per la classe messaggio Calendar. Le impostazioni del contenuto gestito vengono applicate alla cartella predefinita Calendario. Il mantenimento è abilitato e gli elementi vengono spostati nella cartella Posta eliminata dopo 180 giorni.

Parametri

-AddressForJournaling

Il parametro AddressForJournaling specifica il destinatario del journaling in cui vengono inviati i messaggi nel journal. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Nome distinto canonico
• GUID

Tale parametro è obbligatorio se il parametro JournalingEnabled è impostato su $true.

Type:	RecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AgeLimitForRetention

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 tale parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

-DomainController

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

-FolderName

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

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-JournalingEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LabelForJournaling

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageClass

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 del parametro può essere un tipo di messaggio conosciuto, ad esempio elementi del calendario, una classe di messaggi specifica, come IPM.NOTE.SMIME o una classe di messaggi personalizzata. È possibile utilizzare i seguenti tipi di messaggio conosciuti:

• Per 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 delJournal, utilizzare il valore IPM.Activity.
• Per il tipo di messaggio Convocazione, risposta e annullamento riunione, utilizzare il valore IPM.Schedule*.
• Per il tipo di messaggio Note, utilizzare il valore IPM.StickyNote.
• Per il tipo di messaggio Post, 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 Posta vocale, utilizzare il valore IPM.Note.Microsoft.Voicemail*.

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 vengono applicate a tutte le classi di messaggi.
• Una classe di messaggi specifica con il carattere jolly asterisco. Il carattere jolly dell'asterisco deve essere visualizzato come ultimo carattere nella classe messaggio. Ad esempio, IPM. NOTA* (include IPM. NOTE e tutte le sottoclassi) o IPM. NOTA.* (include le sottoclassi per IPM. NOTA ma non IPM. nota stessa). *. NOTE e IPM.*. NOTA non sono valori validi.

Note:

• Quando vengono utilizzati caratteri jolly, questi criteri vengono applicati solo alle classi di messaggi prive di un'impostazione specifica per il contenuto. Pertanto, IPM.NOTE.SMIME ha la precedenza su IPM.NOTE.*.
• Le impostazioni specifiche sostituiscono le impostazioni generali, ad esempio Voicemail sostituisce AllMailboxContent.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageFormatForJournaling

Il parametro MessageFormatForJournaling consente di specificare il formato del messaggio da utilizzare per inserire un elemento nel journal. È possibile utilizzare i seguenti valori:

• Formato msg di UseMsg Outlook
• Usare il formato MAPI di OutlookTnef

Type:	JournalingFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MoveToDestinationFolder

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 il valore del parametro RetentionAction è MoveToFolder, viene restituito un errore.

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionAction

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 tale parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.

Type:	RetentionAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionEnabled

Il parametro RetentionEnabled indica che il mantenimento è abilitato quando è impostato su $true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TriggerForRetention

Il parametro TriggerForRetention specifica la data considerata come data di inizio del periodo di mantenimento. Un elemento può raggiungere il limite di mantenimento in uno specifico numero di giorni dopo il suo recapito o dopo il suo spostamento in una cartella specifica.

Tra i valori validi sono inclusi:

• WhenDelivered
• WhenMoved

Questo valore corrisponde al 0x4 bit dell'attributo msExchELCFlags in Active Directory. Il flag è impostato su $true se l'elemento scadrà in base alla data di spostamento o su $false se scadrà in base alla data di recapito.

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

Type:	RetentionDateType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

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.