New-ComplianceRetentionEvent

Este cmdlet está disponible solo en el PowerShell del Centro de seguridad y cumplimiento. Para obtener más información, consulte PowerShell del Centro de seguridad y cumplimiento.

Use el cmdlet New-ComplianceRetentionEvent para crear eventos de retención de cumplimiento en su organización.

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-ComplianceRetentionEvent
   -Name <String>
   [-AssetId <String>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-EventDateTime <DateTime>]
   [-EventTags <MultiValuedProperty>]
   [-EventType <ComplianceRuleIdParameter>]
   [-ExchangeAssetIdQuery <String>]
   [-PreviewOnly]
   [-SharePointAssetIdQuery <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Necesita que se le asignen permisos en el Centro de seguridad y cumplimiento para poder usar este cmdlet. Para más información, consulte Permisos en el Centro de seguridad y cumplimiento.

Ejemplos

Ejemplo 1

New-ComplianceRetentionEvent -Name "Research Project Employees" -EventTag 80e0d620-13ea-4ed9-b6a6-aa883278bcca -EventType e823b782-9a07-4e30-8091-034fc01f9347 -SharePointAssetIDQuery "EmployeeNumber:123456 EmployeeNumber:456789"

En este ejemplo se crea un evento de retención de cumplimiento denominado Research Project Employees con la siguiente configuración:

  • EventTag: 80e0d620-13ea-4ed9-b6a6-aa883278bcca
  • EventTpe: e823b782-9a07-4e30-8091-034fc01f9347
  • SharePointAssetIDQuery: EmployeeNumber:123456 EmployeeNumber:456789

Parámetros

-AssetId

El parámetro AssetId especifica el par Property:Value que se encuentra en las propiedades de los documentos de SharePoint o OneDrive para la Empresa que se usan para la retención. Por ejemplo:

  • Códigos de producto que puede usar para conservar contenido solo para un producto específico.
  • Códigos de proyecto que puede usar para conservar contenido solo para un proyecto específico.
  • Id. de empleado que puede usar para conservar contenido solo para una persona específica.
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Comment

El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-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, los 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 otros cmdlets (por ejemplo, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-DomainController

Este parámetro está reservado para uso interno de Microsoft.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-EventDateTime

El parámetro EventDateTime especifica la fecha y hora del evento.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-EventTags

El parámetro EventTags especifica el valor GUID de las etiquetas tha están asociadas con el evento de retención de cumplimiento. Ejecute el siguiente comando para ver los valores GUID disponibles: Get-ComplianceTag | Format-Table Name,GUID .

Puede especificar distintos valores separados por comas.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-EventType

El parámetro EventType especifica el valor GUID del evento que iniciará el período de retención de las etiquetas que usan este tipo de evento. Ejecute el siguiente comando para ver los valores GUID disponibles: Get-ComplianceRetentionEventType | Format-Table Name,GUID .

Type:ComplianceRuleIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-ExchangeAssetIdQuery

El parámetro ExchangeAssetIdQuery especifica las palabras clave que se usan para el ámbito del contenido de Exchange para el evento de retención de cumplimiento. Para obtener más información, vea Consultas de palabras clave y condiciones de búsqueda para Búsqueda de contenido.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Name

El parámetro Name especifica un nombre único para el evento de retención de cumplimiento. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-PreviewOnly

{{ Fill PreviewOnly Description }}

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-SharePointAssetIdQuery

El parámetro SharePointAssetIdQuery especifica uno o varios pares Property:Value que ha especificado en las propiedades (también conocidas como Columns) de los documentos de SharePoint y OneDrive para la Empresa para el ámbito del evento de retención de cumplimiento.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-WhatIf

El modificador WhatIf no funciona en el PowerShell del Centro de seguridad y cumplimiento.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center

Entradas

Salidas