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.
Los valores de parámetro válidos para las clases de mensaje personalizadas son:
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.
|
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:
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"