New-RetentionCompliancePolicy

Sintaxis

Default

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>]

TeamLocation

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>]

AdaptiveScopeLocation

New-RetentionCompliancePolicy
    [-Name] <String>
    -AdaptiveScopeLocation <MultiValuedProperty>
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-Force]
    [-IsSimulation]
    [-PriorityCleanup]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SkipPriorityCleanupConfirmation]
    [-WhatIf]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1

New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

Ejemplo 2

New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."

Parámetros

-AdaptiveScopeLocation

Aplicable: Seguridad & cumplimiento

El parámetro AdaptiveScopeLocation especifica la ubicación del ámbito adaptable que se incluirá en la directiva. Los ámbitos adaptables se crean mediante el cmdlet New-AdaptiveScope. Puedes usar cualquier valor que identifique de forma única el ámbito adaptable. Por ejemplo:

• Nombre
• Nombre completo (DN)
• GUID

Propiedades de parámetro

Conjuntos de parámetros

-Applications

Aplicable: Seguridad & cumplimiento

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 que está 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 valor es el predeterminado y es funcionalmente equivalente al valor "Group:Exchange,SharePoint".

Propiedades de parámetro

Conjuntos de parámetros

-Comment

Aplicable: Seguridad & cumplimiento

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".

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Aplicable: Seguridad & cumplimiento

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Conjuntos de parámetros

-Enabled

Aplicable: Seguridad & cumplimiento

El parámetro Enabled especifica si la directiva está habilitada o deshabilitada. Los valores admitidos son:

• $true: la directiva está habilitada. Este valor es el predeterminado.
• $true: la directiva está habilitada. Es el valor predeterminado.

Propiedades de parámetro

Conjuntos de parámetros

-ExchangeLocation

Aplicable: Seguridad & cumplimiento

El parámetro ExchangeLocation especifica los buzones que se incluirán 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
• El valor Todo 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.

Propiedades de parámetro

Conjuntos de parámetros

-ExchangeLocationException

Aplicable: Seguridad & cumplimiento

El parámetro ExchangeLocationException especifica los buzones que se excluirán de la directiva cuando se usa el valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-Force

Aplicable: Seguridad & cumplimiento

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.

Propiedades de parámetro

Conjuntos de parámetros

-IsSimulation

Aplicable: Seguridad & cumplimiento

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.

Propiedades de parámetro

Conjuntos de parámetros

-ModernGroupLocation

Aplicable: Seguridad & cumplimiento

El parámetro ModernGroupLocation especifica los Grupos de Microsoft 365 que se incluirán en la directiva. Los valores admitidos son:

• Un grupo de Microsoft 365
• El valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-ModernGroupLocationException

Aplicable: Seguridad & cumplimiento

El parámetro ModernGroupLocationException especifica los Grupos de Microsoft 365 que se excluirán de la directiva cuando se usa el valor Todos para el parámetro ModernGroupLocation.

Puede usar cualquier valor que identifique de forma única al 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".

Propiedades de parámetro

Conjuntos de parámetros

-Name

Aplicable: Seguridad & cumplimiento

El parámetro Name especifica el nombre único de la directiva de retención. Si el valor contiene espacios, escríbalo entre comillas.

Propiedades de parámetro

Conjuntos de parámetros

-OneDriveLocation

Aplicable: Seguridad & cumplimiento

El parámetro OneDriveLocation especifica los sitios de OneDrive que se incluirán. 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".

Propiedades de parámetro

Conjuntos de parámetros

-OneDriveLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de OneDrive que se excluirán al usar el valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-PolicyRBACScopes

Aplicable: Seguridad & cumplimiento

Nota: Las unidades de Administración no se admiten actualmente, por lo que este parámetro no es funcional. La información que se presenta aquí es para fines informativos cuando se libera soporte para unidades de administración.

El parámetro PolicyRBACScopes especifica las unidades administrativas que se asignarán a la directiva. Un valor válido es el ObjectID de Microsoft Entra (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 Microsoft Graph PowerShell.

Propiedades de parámetro

Conjuntos de parámetros

-PolicyTemplateInfo

Aplicable: Seguridad & cumplimiento

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

Propiedades de parámetro

Conjuntos de parámetros

-PriorityCleanup

Aplicable: Seguridad & cumplimiento

El modificador PriorityCleanup especifica si se creará una directiva de limpieza de prioridad. No es necesario especificar un valor con este modificador.

Las directivas de limpieza de prioridad aceleran la eliminación de contenido confidencial reemplazando cualquier configuración de retención existente o suspensiones de exhibición de documentos electrónicos. Para obtener más información, vea Limpieza de prioridad.

Propiedades de parámetro

Conjuntos de parámetros

-PublicFolderLocation

Aplicable: Seguridad & cumplimiento

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.

Propiedades de parámetro

Conjuntos de parámetros

-RestrictiveRetention

Aplicable: Seguridad & cumplimiento

El parámetro RestrictiveRetention especifica si el bloqueo de conservación está habilitado para la directiva. Los valores admitidos son:

• $true: El bloqueo de conservación está habilitado para la directiva. Nadie, incluido un administrador, puede desactivar la directiva o hacerla menos restrictiva.
• $false: El bloqueo de conservación no está habilitado para la directiva. Este valor es el predeterminado.

Después de bloquear una directiva, nadie puede desactivarla, deshabilitarla o quitar contenido de la directiva. Además, no es posible modificar ni 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 o 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.

Propiedades de parámetro

Conjuntos de parámetros

-RetainCloudAttachment

Aplicable: Seguridad & cumplimiento

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 valor es el predeterminado.

Para el valor $true, solo puedes 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 discográfica o una etiqueta reglamentaria. No puede usar una etiqueta de publicación para que una directiva de datos adjuntos en la nube cree una regla; Solo se admite aplicar etiquetas.

El parámetro RetainCloudAttachment no está disponible en el cmdlet Set-RetentionCompliancePolicy.

Propiedades de parámetro

Conjuntos de parámetros

-SharePointLocation

Aplicable: Seguridad & cumplimiento

El parámetro SharePointLocation especifica los sitios de SharePoint que se incluirán. 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 no se pueden agregar a la directiva hasta que se hayan indexado. Si no se especifican sitios, no se colocan sitios en suspensión.

Propiedades de parámetro

Conjuntos de parámetros

-SharePointLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de SharePoint que se excluirán cuando se usa el valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-SkipPriorityCleanupConfirmation

Aplicable: Seguridad & cumplimiento

{{ Fill SkipPriorityCleanupConfirmation Description }}

Propiedades de parámetro

Conjuntos de parámetros

-SkypeLocation

Aplicable: Seguridad & cumplimiento

El parámetro SkypeLocation especifica los usuarios de Skype Empresarial Online 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".

Propiedades de parámetro

Conjuntos de parámetros

-SkypeLocationException

Aplicable: Seguridad & cumplimiento

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

Propiedades de parámetro

Conjuntos de parámetros

-TeamsChannelLocation

Aplicable: Seguridad & cumplimiento

El parámetro TeamsChannelLocation especifica los equipos que se incluirán 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".

Propiedades de parámetro

Conjuntos de parámetros

-TeamsChannelLocationException

Aplicable: Seguridad & cumplimiento

El parámetro TeamsChannelLocationException especifica los equipos que se excluirán cuando se usa el valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-TeamsChatLocation

Aplicable: Seguridad & cumplimiento

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".

Propiedades de parámetro

Conjuntos de parámetros

-TeamsChatLocationException

Aplicable: Seguridad & cumplimiento

El parámetro TeamsChatLocationException especifica los usuarios de Teams que se excluirán cuando se usa el valor Todos 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".

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Aplicable: Seguridad & cumplimiento

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters