New-RetentionCompliancePolicy
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet New-RetentionCompliancePolicy para crear nuevas directivas de retención y nuevas directivas de etiqueta de retención en el portal de cumplimiento Microsoft Purview. La creación de una nueva directiva también requiere el uso del cmdlet New-RetentionComplianceRule.
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.
Sintaxis
New-RetentionCompliancePolicy
[-Name] <String>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-IsSimulation]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-PriorityCleanup]
[-PublicFolderLocation <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkipPriorityCleanupConfirmation]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
New-RetentionCompliancePolicy
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-PriorityCleanup]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SkipPriorityCleanupConfirmation]
[-TeamsChannelLocation <MultiValuedProperty>]
[-TeamsChannelLocationException <MultiValuedProperty>]
[-TeamsChatLocation <MultiValuedProperty>]
[-TeamsChatLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
New-RetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-PriorityCleanup]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SkipPriorityCleanupConfirmation]
[-WhatIf]
[<CommonParameters>]
Description
Las directivas no son válidas hasta que se agrega una regla (para las directivas de retención) o se agrega una etiqueta (para las directivas de etiqueta de retención). Para obtener más información, vea New-RetentionComplianceRule. Además, se debe definir al menos un parámetro de ubicación para crear una directiva de retención o una directiva de etiqueta de retención.
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información, vea [Permisos en el portal de cumplimiento Microsoft Purview]/purview/microsoft-365-compliance-center-permissions).
Ejemplos
Ejemplo 1
New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"
En este ejemplo se crea una directiva de retención denominada "Cumplimiento del Reglamento 123" para los buzones de Correo de Kitty Petersen y Scott Nakamura, y el sitio financiero de SharePoint Online.
El siguiente paso es usar el cmdlet New-RetentionComplianceRule para agregar una regla a la directiva de retención.
Ejemplo 2
New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."
En este ejemplo se crea una nueva directiva de etiqueta de aplicación automática destinada a datos adjuntos en la nube denominado Departamento de marketing con los detalles especificados.
El siguiente paso es usar el cmdlet New-RetentionComplianceRule para agregar una etiqueta de retención a la directiva de etiquetas de retención.
Parámetros
-AdaptiveScopeLocation
El parámetro AdaptiveScopeLocation especifica la ubicación del ámbito adaptable que se va a incluir en la directiva. Los ámbitos adaptables se crean mediante el cmdlet New-AdaptiveScope. Puede usar cualquier valor que identifique de forma única el ámbito adaptable. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-Applications
El parámetro Applications especifica el destino cuando se incluyen Grupos de Microsoft 365 en la directiva (se establece el parámetro ModernGroups). Los valores admitidos son:
-
Group:Exchange
para el buzón que está conectado al grupo de Microsoft 365. -
Group:SharePoint
para el sitio de SharePoint conectado al grupo de Microsoft 365. -
"Group:Exchange,SharePoint"
tanto para el buzón como para el sitio de SharePoint que están conectados al grupo de Microsoft 365. - blank (
$null
): este es el valor predeterminado y es funcionalmente equivalente al valor"Group:Exchange,SharePoint"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-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".
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-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.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-Enabled
El parámetro Enabled especifica si la directiva está habilitada o deshabilitada. Los valores admitidos son:
- $true: la directiva está habilitada. Este es el valor predeterminado.
- $true: la directiva está habilitada. Es el valor predeterminado.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-ExchangeLocation
El parámetro ExchangeLocation especifica los buzones que se van a incluir en la directiva. Los valores admitidos son:
- El parámetro ExchangeLocation especifica los buzones de correo que se incluirán en la directiva. Los valores válidos son:
- Un buzón de correo
- Valor All para todos los buzones. Este valor únicamente se puede usar solo.
El valor All para todos los buzones. Solo puede utilizar este valor por sí mismo.
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Si no se especifican buzones, no se colocan buzones en suspensión.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-ExchangeLocationException
El parámetro ExchangeLocationException especifica los buzones que se van a excluir de la directiva cuando se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- Este parámetro especifica los buzones de correo que se eliminarán de la lista de buzones excluidos al usar el valor All para el parámetro ExchangeLocation. Los valores válidos son:
- Un buzón de correo
El valor All para todos los buzones. Solo puede utilizar este valor por sí mismo.
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-Force
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-IsSimulation
El modificador IsSimulation especifica que la directiva se crea en modo de simulación. No es necesario especificar un valor con este modificador.
Para obtener más información sobre el modo de simulación, consulte Más información sobre el modo de simulación.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-ModernGroupLocation
El parámetro ModernGroupLocation especifica el Grupos de Microsoft 365 que se va a incluir en la directiva. Los valores admitidos son:
- Un grupo de Microsoft 365
- Valor All para todos los Grupos de Microsoft 365. Este valor únicamente se puede usar solo.
Para identificar el grupo de Microsoft 365, puede usar cualquier valor que lo identifique de forma única. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-ModernGroupLocationException
El parámetro ModernGroupLocationException especifica el Grupos de Microsoft 365 que se va a excluir de la directiva cuando se usa el valor All para el parámetro ModernGroupLocation.
Puede usar cualquier valor que identifique de forma única el grupo de Microsoft 365. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-Name
El parámetro Name especifica el nombre único de la directiva de retención. Si el valor contiene espacios, escríbalo entre comillas.
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-OneDriveLocation
El parámetro OneDriveLocation especifica los sitios OneDrive para la Empresa que se van a incluir. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-OneDriveLocationException
Este parámetro especifica los sitios de OneDrive para la Empresa que se van a excluir cuando se usa el valor All para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-PolicyRBACScopes
El parámetro PolicyRBACScopes especifica las unidades administrativas que se van a asignar a la directiva. Un valor válido es el Microsoft Entra ObjectID (valor GUID) de la unidad administrativa. Puede especificar distintos valores separados por comas.
Las unidades administrativas solo están disponibles en Microsoft Entra ID P1 o P2. Puede crear y administrar unidades administrativas en PowerShell de Microsoft Graph.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-PolicyTemplateInfo
Este parámetro está reservado para uso interno de Microsoft.
Tipo: | PswsHashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-PublicFolderLocation
El parámetro PublicFolderLocation especifica que desea incluir todas las carpetas públicas en la directiva de retención. Use el valor All para este parámetro.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-RestrictiveRetention
El parámetro RestrictiveRetention especifica si el bloqueo de conservación está habilitado para la directiva. Los valores admitidos son:
- $true: Bloqueo de conservación está habilitado para la directiva. Nadie, incluido un administrador, puede desactivar la directiva o hacer que sea menos restrictiva.
- $false: El bloqueo de conservación no está habilitado para la directiva. Este es el valor predeterminado.
Una vez se haya bloqueado una directiva, nadie podrá desactivarla, deshabilitarla ni quitar contenido de ella. Y no es posible modificar o eliminar el contenido que está sujeto a la directiva durante el período de retención. La única manera de modificar la directiva de retención consiste en agregarle contenido o ampliar su duración. Una directiva bloqueada se puede aumentar o ampliar, pero no se puede reducir, deshabilitar ni desactivar.
Por lo tanto, antes de bloquear una directiva de retención, es fundamental que comprenda los requisitos de cumplimiento de su organización y que no bloquee una directiva hasta que esté seguro de que es lo que necesita.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-RetainCloudAttachment
Nota: Este parámetro está actualmente en versión preliminar, no está disponible en todas las organizaciones y está sujeto a cambios.
El parámetro RetainCloudAttachment especifica que se trata de una directiva de datos adjuntos en la nube. Los valores admitidos son:
- $true: La directiva es una directiva de datos adjuntos en la nube.
- $false: La directiva no es una directiva de datos adjuntos en la nube. Este es el valor predeterminado.
Para el valor $true, solo puede usar los siguientes parámetros de ubicación:
- SharePointLocation y SharePointLocationException
- OneDriveLocation y OneDriveLocationException
- ModernGroupLocation y ModernGroupLocationException
Una etiqueta que usa una directiva de datos adjuntos en la nube para crear una regla puede ser una etiqueta de registro o una etiqueta normativa. No puede usar una etiqueta de publicación para una directiva de datos adjuntos en la nube para crear una regla; solo se admiten etiquetas de aplicación.
El parámetro RetainCloudAttachment no está disponible en el cmdlet Set-RetentionCompliancePolicy.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-SharePointLocation
El parámetro SharePointLocation especifica los sitios de SharePoint Online que se van a incluir. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Los sitios de SharePoint Online no se pueden agregar a la directiva hasta que se hayan indexado. Si no se especifican sitios, no se colocan sitios en suspensión.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-SharePointLocationException
Este parámetro especifica los sitios de SharePoint Online que se van a excluir cuando se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-SkipPriorityCleanupConfirmation
{{ Fill SkipPriorityCleanupConfirmation Description }}
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-SkypeLocation
El parámetro SkypeLocation especifica los Skype Empresarial usuarios en línea que se incluirán en la directiva.
Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-SkypeLocationException
Este parámetro está reservado para uso interno de Microsoft.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-TeamsChannelLocation
El parámetro TeamsChannelLocation especifica los equipos que se van a incluir en la directiva.
Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:
- Nombre
- Dirección de correo electrónico
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-TeamsChannelLocationException
El parámetro TeamsChannelLocationException especifica los equipos que se van a excluir cuando se usa el valor All para el parámetro TeamsChannelLocation. Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:
- Nombre
- Dirección de correo electrónico
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-TeamsChatLocation
El parámetro TeamsChatLocation especifica los usuarios de Teams que se incluirán en la directiva.
Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-TeamsChatLocationException
El parámetro TeamsChatLocationException especifica los usuarios de Teams que se excluirán cuando use el valor All para el parámetro TeamsChatLocation. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (DN)
- GUID
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN"
.
Tipo: | MultiValuedProperty |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |
-WhatIf
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Security & Compliance |