Set-AppRetentionCompliancePolicy

Sintaxis

Identity (Es el valor predeterminado).

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-Applications <String[]>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddAdaptiveScopeLocation <MultiValuedProperty>]
    [-Applications <String[]>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

DisableRestrictiveRetentionParameterSet

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-WhatIf]
    [<CommonParameters>]

InformationBarrierDefault

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

OrganizationSegmentsDefault

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-WhatIf]
    [<CommonParameters>]

RetryDistributionParameterSet

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-RetryDistribution]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1

Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,VivaEngage" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"

Ejemplo 2

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@
Set-AppRetentionCompliancePolicy -Identity "Teams Private Channel Retention Policy" -AddExchangeLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

Ejemplo 3

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@
Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" -AddExchangeLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Parámetros

-AddAdaptiveScopeLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro AddAdaptiveScopeLocation especifica la ubicación del ámbito adaptable que se va a agregar a 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

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Propiedades del parámetro

Conjuntos de parámetros

-AddExchangeLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro AddExchangeLocation especifica los buzones que se van a agregar a la lista de buzones incluidos cuando no se usa el valor All para el parámetro ExchangeLocation. 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 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 del parámetro

Conjuntos de parámetros

-AddExchangeLocationException

Aplicable: Cumplimiento de & de seguridad

El parámetro AddExchangeLocationException especifica los buzones que se van a agregar a la lista de buzones excluidos 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".

Propiedades del parámetro

Conjuntos de parámetros

-AddModernGroupLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro AddModernGroupLocation especifica el Grupos de Microsoft 365 que se va a agregar a la lista de Grupos de Microsoft 365 incluidas cuando no 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".

Propiedades del parámetro

Conjuntos de parámetros

-AddModernGroupLocationException

Aplicable: Cumplimiento de & de seguridad

El parámetro AddModernGroupLocationException especifica el Grupos de Microsoft 365 que se va a agregar a la lista de Grupos de Microsoft 365 excluidas 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".

Propiedades del parámetro

Conjuntos de parámetros

-Applications

Aplicable: Cumplimiento de & de seguridad

El parámetro Applications especifica las aplicaciones que se van a incluir en la directiva.

Este parámetro usa la sintaxis siguiente: "LocationType:App1,LocationType:App2,...LocationType:AppN

LocationType es Usuario o Grupo.

App es un valor admitido como se muestra en los ejemplos siguientes.

• Aplicaciones de Microsoft 365: por ejemplo:

  "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" o "User:MicrosoftTeams","User:VivaEngage"

• Microsoft Copilot experiencias: actualmente en versión preliminar. Debe usar todos los valores siguientes al mismo tiempo:

  "User:M365Copilot,CopilotForSecurity,CopilotinFabricPowerBI,CopilotStudio,CopilotinBusinessApplicationplatformsSales,SQLCopilot"

  Nota: Aunque debe usar CopilotinBusinessApplicationplatformsSales y SQLCopilot, esos valores son actualmente irrelevantes.

• Aplicaciones de inteligencia artificial empresarial: actualmente en versión preliminar. Debe usar todos los valores siguientes al mismo tiempo:

  "User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"

• Otras aplicaciones de inteligencia artificial: actualmente en versión preliminar. Debe usar todos los valores siguientes al mismo tiempo:

  "User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"

Propiedades del parámetro

Conjuntos de parámetros

-Comment

Aplicable: Cumplimiento de & de seguridad

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 del parámetro

Conjuntos de parámetros

-Confirm

Aplicable: Cumplimiento de & de seguridad

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.

Propiedades del parámetro

Conjuntos de parámetros

-DeletedResources

Aplicable: Cumplimiento de & de seguridad

El parámetro DeletedResources especifica el buzón eliminado o el usuario de correo que se va a agregar como exclusión a la lista de ubicaciones correspondiente. Use este parámetro con el parámetro AddTeamsChatLocationException para buzones eliminados o usuarios de correo que deban excluirse de una directiva de retención de Teams.

Un valor válido es una cadena JSON. Consulte la sección Ejemplos para ver ejemplos de sintaxis y uso de este parámetro.

Para obtener información sobre el escenario de buzón inactivo, consulte Información sobre los buzones inactivos.

PRECAUCIÓN: Este parámetro usa la dirección SMTP del buzón o usuario de correo eliminado, que también se puede especificar para otros buzones o usuarios de correo. Si usa este parámetro sin realizar primero pasos adicionales, también se excluyen otros buzones y usuarios de correo con la misma dirección SMTP en la directiva de retención. Para comprobar si hay buzones o usuarios de correo adicionales con la misma dirección SMTP, use el siguiente comando y reemplace por user@contoso.com la dirección SMTP para comprobar: Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted

Para evitar que se excluyan buzones activos o usuarios de correo con la misma dirección SMTP, coloque el buzón en suspensión por juicio antes de ejecutar el comando con el parámetro DeletedResources.

Propiedades del parámetro

Conjuntos de parámetros

-Enabled

Aplicable: Cumplimiento de & de seguridad

El parámetro Enabled habilita o deshabilita la directiva. Los valores admitidos son:

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

Propiedades del parámetro

Conjuntos de parámetros

-Force

Aplicable: Cumplimiento de & de seguridad

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 del parámetro

Conjuntos de parámetros

-Identity

Aplicable: Cumplimiento de & de seguridad

El parámetro Identity especifica la directiva de cumplimiento de retención de aplicaciones que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

• Nombre
• Nombre completo (DN)
• GUID

Propiedades del parámetro

Conjuntos de parámetros

-PolicyRBACScopes

Aplicable: Cumplimiento de & de seguridad

Nota: actualmente no se admiten las unidades Administración, por lo que este parámetro no es funcional. La información que se presenta aquí tiene fines informativos cuando se publica la compatibilidad con unidades de administración.

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.

Propiedades del parámetro

Conjuntos de parámetros

-RemoveAdaptiveScopeLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro RemoveAdaptiveScopeLocation especifica la ubicación del ámbito adaptable que se va a quitar de 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

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Propiedades del parámetro

Conjuntos de parámetros

-RemoveExchangeLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro RemoveExchangeLocation especifica los buzones que se van a quitar de la lista de buzones incluidos cuando no 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".

Propiedades del parámetro

Conjuntos de parámetros

-RemoveExchangeLocationException

Aplicable: Cumplimiento de & de seguridad

El parámetro RemoveExchangeLocationException especifica los buzones que se van a quitar de la lista de buzones excluidos 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".

Propiedades del parámetro

Conjuntos de parámetros

-RemoveModernGroupLocation

Aplicable: Cumplimiento de & de seguridad

El parámetro RemoveModernGroupLocation especifica la Grupos de Microsoft 365 que se va a quitar de la lista de grupos incluidos cuando no 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".

Propiedades del parámetro

Conjuntos de parámetros

-RemoveModernGroupLocationException

Aplicable: Cumplimiento de & de seguridad

El parámetro RemoveModernGroupLocationException especifica el Grupos de Microsoft 365 que se va a quitar de la lista de grupos excluidos 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".

Propiedades del parámetro

Conjuntos de parámetros

-RestrictiveRetention

Aplicable: Cumplimiento de & de seguridad

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

Una vez bloqueada una directiva, nadie puede desactivarla o deshabilitarla, ni quitar aplicaciones de la directiva. Las únicas maneras de modificar la directiva son agregarle aplicaciones 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, 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 del parámetro

Conjuntos de parámetros

-RetryDistribution

Aplicable: Cumplimiento de & de seguridad

El modificador RetryDistribution especifica si se va a redistribuir la directiva a todas las ubicaciones. No es necesario especificar un valor con este modificador.

No se incluyen en el reintento aquellas ubicaciones cuyas distribuciones iniciales fueron correctas. Cuando se usa este modificador, los errores de distribución de directivas se notifican.

Nota: Dado que el proceso de reintento de distribución es una operación significativa, ejecútelo solo si es necesario y para una directiva a la vez. No está pensado para ejecutarse cada vez que se actualiza una directiva. Si ejecuta un script para actualizar varias directivas, espere hasta que la distribución de la directiva se realice correctamente antes de volver a ejecutar el comando para la siguiente directiva.

Propiedades del parámetro

Conjuntos de parámetros

-WhatIf

Aplicable: Cumplimiento de & de seguridad

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Propiedades del parámetro

Conjuntos de parámetros

CommonParameters