Share via


New-ManagedContentSettings

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-09-16

Use el cmdlet New-ManagedContentSettings para crear una nueva configuración de contenido administrado para las carpetas administradas.

Sintaxis

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>]]

Descripción detallada

La configuración del contenido administrado se aplica a las carpetas administradas para controlar el ciclo de vida de los elementos de los buzones de los usuarios. Hay dos formas de controlar el ciclo de vida:

  • Controlar la retención del contenido y eliminar el contenido que no se necesite.

  • Registrar en el diario automáticamente el contenido importante en una ubicación de almacenamiento independiente fuera del buzón.

Para obtener más información acerca de la configuración del contenido administrado, consulte Administración de registros de mensajería.

Para ejecutar el cmdlet New-ManagedContentSettings, la cuenta que use debe tener delegada la siguiente función:

  • Función de Administrador de la organización de Exchange

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

FolderName

Necesario

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

El parámetro FolderName especifica el nombre o GUID de la carpeta administrada a la que se aplica la configuración del contenido administrado.

MessageClass

Necesario

System.String

El parámetro MessageClass especifica el tipo de mensaje al que se aplica cualquier configuración de exiración y de registro en el diario que esté dentro de las configuraciones de contenido.

  • El valor del parámetro debe ser una clase de mensaje concreta, como IPM.NOTE.SMIME o una clase de mensaje personalizada.

Los valores de parámetro válidos para las clases de mensaje personalizadas son:

  • Una clase de mensaje específica (por ejemplo, IPM.NOTE)

  • El carácter comodín asterisco (*), que indica que la configuración de contenido se aplica a todas las clases de mensaje.

  • Una clase de mensaje específica que tiene el carácter comodín asterisco. El carácter comodín asterisco debe ser el último carácter de la clase de mensaje.

    Ejemplos:

    • IPM.NOTE* (incluye IPM.NOTE y todas las subclases)

    • IPM.NOTE.* (incluye las subclases de IPM.NOTE, pero no IPM.NOTE)

    • *.NOTE y IPM.*.NOTE no se aceptan.

Nota

Cuando se utilizan caracteres comodín, estas directivas se aplican sólo a las clases de mensaje que no tienen una configuración de contenido específica. Por lo tanto, IPM.NOTE.SMIME invalida IPM.NOTE.*

Nota

La configuración específica reemplaza la configuración general. Por ejemplo, Correo de voz reemplaza a Todo el contenido del buzón.
En la lista siguiente se describen los tipos de mensaje conocidos y se ofrecen los valores que deben usarse:

  • Para el tipo Todos los mensajes de contenido del buzón, use el valor *.

  • Para el tipo de mensaje Elementos del calendario, use el valor IPM.Appointment*.

  • Para el tipo de mensaje Contactos, use el valor IPM.Contact*.

  • Para el tipo de mensaje Documentos, use el valor IPM.Document*.

  • Para el tipo de mensaje Faxes, use el valor IPM.Note.Microsoft.Fax.

  • Para el tipo de mensaje Diario, use el valor IPM.Activity.

  • Para el tipo de mensaje Convocatorias de reunión, respuestas y cancelaciones, use el valor IPM.Schedule*.

  • Para el tipo de mensaje Notas, use el valor IPM.StickyNote.

  • Para el tipo de mensaje Elementos para exponer, use el valor IPM.Post*.

  • Para el tipo de mensaje Elementos RSS, use el valor IPM.Post.RSS.

  • Para el tipo de mensaje Tareas, use el valor IPM.Task*.

  • Para el tipo de mensaje Mensaje de voz, use el valor IPM.Note.Microsoft.Voicemail*.

Name

Necesario

System.String

El parámetro Name indica un nombre exclusivo para la configuración del contenido administrado.

AddressForJournaling

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

El parámetro AddressForJournaling especifica la dirección del almacén que será el destino de la operación de registro en el diario. Si el parámetro no está y el parámetro JournalingEnabled está definido en $true, se devuelve un error.

AgeLimitForRetention

Opcional

System.Nullable

El parámetro AgeLimitForRetention especifica la antigüedad en la que se establece la expiración de un elemento. El límite de antigúdad corresponde al número de días desde la fecha en que el elemento se entregó o, si no se entregó, la fecha en que el elemento fue creado. Si el parámetro no está y el parámetro RetentionEnabled está definido en $true, se devuelve un error.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que escribe esta información de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando.

JournalingEnabled

Opcional

System.Boolean

El parámetro JournalingEnabled indica que el registro en el diario se habilita cuando se establece en $true.

LabelForJournaling

Opcional

System.String

El parámetro LabelForJournaling especifica una etiqueta que se adjunta a un elemento. Esta etiqueta se usa en el almacén de destino para determinar el contenido de un elemento y establecer la directiva apropiada.

MessageFormatForJournaling

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

El parámetro MessageFormatForJournaling habilita al administrador para especificar que un elemento pueda ser registrado en el diario en formato .msg de Microsoft Outlook o en el formato MAPI de Outlook tradicional.

MoveToDestinationFolder

Opcional

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

El parámetro MoveToDestinationFolder especifica la carpeta de destino de una acción de movimiento.

La carpeta de destino debe ser una carpeta organizativa personalizada existente. Si no es así, se devuelve un error. Si el parámetro MoveToDestinationFolder no está y la acción de expiración es MoveToFolder, se devuelve un error.

RetentionAction

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

El parámetro RetentionAction especifica una de las siguientes acciones:

  • Marcar como límite de expiración pasada

  • Mover a carpeta administrada personalizada

  • Mover a la carpeta elementos eliminados

  • Eliminar y permitir la recuperación

  • Eliminar permanentemente

Si el parámetro no está y el parámetro RetentionEnabled está definido en $true, se devuelve un error.

RetentionEnabled

Opcional

System.Boolean

El parámetro RetentionEnabled especifica que la expiración está habilitada cuando se establece en $true.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando un objeto existente se suministra al parámetro TemplateInstance, el comando usa la configuración de ese objeto para crear un duplicado exacto del objeto en un servidor de destino o local.

TriggerForRetention

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

Este parámetro TriggerForRetention indica la fecha de inicio que se usará como el período de inicio o de expiración. Un elemento puede tener como límite de expiración un número específico de días tras ser entregado o tras ser movido a una carpeta específica.

Este valor corresponde a los 0x4 bytes del atributo msExchELCFlags en Active Directory. TEl marcador está establecido en $true si el elemento expira basándose en la fecha en que se movió y, en $false, si el elemento expira basándose en la fecha de entrega. Si el parámetro no está y el parámetro RetentionEnabled está definido en $true, se devuelve un error.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

  

Excepciones

Excepciones Descripción

  

Ejemplo

En el primer ejemplo, el comando New-ManagedContentSettings se usa para crear configuraciones del contenido administrado de la clase de mensaje Calendario y denominado MyCalendarContentSettings. La configuración del contenido administrado se aplica a la carpeta Calendario predeterminada. La expiración se habilita y los elementos se mueven a la carpeta Elementos eliminados después de 30 días.

En el segundo ejemplo, las rutas internas (de una clase de mensaje personalizada denominada IPM.Note.Archive.Shortcut) del contenido archivado de las bandejas de entrada de los usuarios se eliminan con la opción de contenido administrado denominada RemoveArchiveStubs.

Para obtener más información acerca de las clases de mensaje personalizadas, consulte la descripción del parámetro "MessageClass" en este tema, así como la sección sobre clases de mensaje del artículo 241235 de Microsoft Knowledge Base, Cómo cambiar globalmente los formularios predeterminados de Outlook con la utilidad Administrador de formularios (en inglés).

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"