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
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
{{ Fill PreviewOnly Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance Center |
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 |
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