Set-AppRetentionCompliancePolicy
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el Set-AppRetentionCompliancePolicy para modificar las directivas de cumplimiento de retención de aplicaciones.
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
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>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-RetryDistribution]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-WhatIf]
[<CommonParameters>] Description
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 de Microsoft Purview.
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"En este ejemplo se agrega un nuevo usuario a la directiva de retención de ámbito estático existente denominada Reglamento 563 Marketing que está configurada para los mensajes de canales privados de Teams.
Parámetros
-AddAdaptiveScopeLocation
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".
| 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 |
-AddExchangeLocation
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".
| 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 |
-AddExchangeLocationException
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".
| 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 |
-AddModernGroupLocation
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".
| 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 |
-AddModernGroupLocationException
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".
| 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 |
-Applications
El parámetro Applications especifica las aplicaciones que se van a incluir y solo es relevante para los siguientes parámetros de ubicación:
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
Este parámetro usa la sintaxis siguiente: "LocationtType:App1,LocationType:App2,...LocationType:AppN donde LocationType es User o Group. Por ejemplo, "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" o "User:MicrosoftTeams","User:VivaEngage".
| 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 |
-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 |
-DeletedResources
{{ Fill DeletedResources Description }}
| 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 |
-Enabled
El parámetro Enabled habilita o deshabilita la directiva. 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 |
-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 |
-Identity
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
| Tipo: | PolicyIdParameter |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| 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 |
-RemoveAdaptiveScopeLocation
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".
| 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 |
-RemoveExchangeLocation
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".
| 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 |
-RemoveExchangeLocationException
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".
| 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 |
-RemoveModernGroupLocation
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".
| 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 |
-RemoveModernGroupLocationException
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".
| 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 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.
| 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 |
-RetryDistribution
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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| 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 |