New-ManagedContentSettings

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Server 2010

Este cmdlet solo está disponible en Exchange Server 2010.

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

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Los valores de la configuración del contenido administrado se deben asociar 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 de contenido y quitar 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 sobre la configuración de contenido administrado, consulte Administración de registros de mensajería.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se crea la configuración del contenido administrado para la carpeta administrada predeterminada Exec-DeletedItems. Si se agrega a una directiva de buzones de carpeta administrada y se aplica a un buzón, los elementos de la carpeta Elementos eliminados se eliminarán de forma permanente 30 días después de la fecha de entrega.

Ejemplo 2

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

En este ejemplo se crea la configuración de contenido administrado CS-Exec-Calendar para la clase de mensaje Calendar. La configuración del contenido administrado se aplica a la carpeta Calendario predeterminada. La retención se habilita y los elementos se mueven a la carpeta Elementos eliminados después de 180 días.

Parámetros

-AddressForJournaling

El parámetro AddressForJournaling especifica el destinatario del registro en diario al que se envían los mensajes en diario. Puede usar cualquier valor que identifique de forma exclusiva el destinatario. Por ejemplo:

• Nombre
• Alias
• Nombre distintivo (DN)
• Nombre distintivo (DN)
• DN canónico
• GUID

Este parámetro se requiere si el parámetro JournalingEnabled está establecido en $true.

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

-AgeLimitForRetention

El parámetro AgeLimitForRetention especifica la antigüedad en la que se establece la expiración de un elemento. El límite de antigüedad corresponde a la cantidad 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 este parámetro no está presente y el parámetro RetentionEnabled está establecido en $true, se devuelve un error.

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

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

• Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
• La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

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

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, 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

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

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

-JournalingEnabled

El parámetro JournalingEnabled especifica que el diario está habilitado cuando se establece en $true.

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

-LabelForJournaling

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.

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

-MessageClass

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

El valor del parámetro puede ser un tipo de mensaje conocido como elementos de calendario, una clase de mensaje específica como IPM.NOTE.SMIME o una clase de mensaje personalizado. Se pueden usar los siguientes tipos de mensajes conocidos:

• Para Todo el 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 de elementos del 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 Exposiciones, 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 Correo de voz, use el valor IPM.Note.Microsoft.Voicemail*.

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

• Una clase de mensaje específico (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 mensajes.
• Una clase de mensaje específica que tiene el carácter comodín asterisco. El carácter comodín de asterisco debe aparecer como el último carácter de la clase de mensaje. Por ejemplo, IPM. NOTA* (incluye IPM. NOTA y todas las subclases) o IPM. NOTA.* (incluye las subclases para IPM. NOTA, pero no IPM. NOTA en sí). *. NOTA e IPM.*. NOTA no son valores válidos.

Notas:

• Cuando se usan caracteres comodín, estas directivas se aplican solo a las clases de mensaje que no tienen una configuración de contenido específica. Por lo tanto, IPM.NOTE.SMIME invalida IPM.NOTE.*.
• La configuración específica reemplaza a la configuración general, por ejemplo, Correo de voz reemplaza a AllMailboxContent.

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

-MessageFormatForJournaling

El parámetro MessageFormatForJournaling especifica el formato de mensaje en el que un elemento está registrado. Puede usar los siguientes valores:

• Formato .msg de UseMsg Outlook
• Use El formato MAPI de Outlook de UseTnef

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

-MoveToDestinationFolder

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í, aparece un error. Si el parámetro MoveToDestinationFolder no está presente y el valor del parámetro RetentionAction es MoveToFolder, aparecerá un error.

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

-Name

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

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

-RetentionAction

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

• Marcar como límite pasado de retención
• Mover a carpeta personalizada administrada
• Mover a la carpeta Elementos eliminados
• Eliminar y permitir la recuperación
• Eliminar permanentemente

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

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

-RetentionEnabled

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

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

-TriggerForRetention

El parámetro TriggerForRetention especifica la fecha que se considera como fecha de inicio para el período de retención. Un elemento puede alcanzar su límite de retención un número determinado de días después de haberse entregado o haberse movido a una carpeta.

Los valores válidos son:

• WhenDelivered
• WhenMoved

Este valor corresponde al bit 0x4 del atributo msExchELCFlags en Active Directory. La marca estará establecida en $true si el elemento expira según la fecha de movimiento y en $false si el elemento expira según la fecha de entrega.

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

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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.