Set-AppRetentionCompliancePolicy

Sintaxis

Identity (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: Seguridad & cumplimiento

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

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

Propiedades de parámetro

Conjuntos de parámetros

-AddExchangeLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddExchangeLocation especifica los buzones que se agregarán a la lista de buzones incluidos cuando no se use 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 de parámetro

Conjuntos de parámetros

-AddExchangeLocationException

Aplicable: Seguridad & cumplimiento

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

-AddModernGroupLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddModernGroupLocation especifica los Grupos de Microsoft 365 que se agregarán a la lista de Grupos de Microsoft 365 incluidos cuando no use 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

-AddModernGroupLocationException

Aplicable: Seguridad & cumplimiento

El parámetro AddModernGroupLocationException especifica los Grupos de Microsoft 365 que se agregan a la lista de Grupos de Microsoft 365 excluidos al usar 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

-Applications

Aplicable: Seguridad & cumplimiento

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

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

LocationType es un usuario o un 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"

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

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

  Nota: Aunque deba usar CopilotinBusinessApplicationplatformsSales and SQLCopilot, esos valores son actualmente irrelevantes.

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

  "User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"

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

  "User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"

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

-DeletedResources

Aplicable: Seguridad & cumplimiento

El parámetro DeletedResources especifica el buzón eliminado o el usuario de correo que se agregará como exclusión a la lista de ubicaciones respectiva. Use este parámetro con el parámetro AddTeamsChatLocationException para los buzones eliminados o los usuarios de correo que necesitan ser excluidos de una directiva de retención solo de Teams.

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

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

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

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

Propiedades de parámetro

Conjuntos de parámetros

-Enabled

Aplicable: Seguridad & cumplimiento

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

-Identity

Aplicable: Seguridad & cumplimiento

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

-RemoveAdaptiveScopeLocation

Aplicable: Seguridad & cumplimiento

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

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

Propiedades de parámetro

Conjuntos de parámetros

-RemoveExchangeLocation

Aplicable: Seguridad & cumplimiento

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

Conjuntos de parámetros

-RemoveExchangeLocationException

Aplicable: Seguridad & cumplimiento

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

-RemoveModernGroupLocation

Aplicable: Seguridad & cumplimiento

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

-RemoveModernGroupLocationException

Aplicable: Seguridad & cumplimiento

El parámetro RemoveModernGroupLocationException especifica los Grupos de Microsoft 365 que se quitarán de la lista de grupos excluidos 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

-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 ni quitar aplicaciones de la directiva. Las únicas maneras de modificar la directiva son agregando aplicaciones o ampliando 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, 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

-RetryDistribution

Aplicable: Seguridad & cumplimiento

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 importante, ejecútelo solo si es necesario y para una directiva a la vez. No está pensado para ejecutarse cada vez que actualice una directiva. Si ejecuta un script para actualizar varias directivas, espere hasta que la distribución de directivas sea correcta antes de volver a ejecutar el comando para la siguiente directiva.

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