New-ManagedContentSettings
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.