New-AppRetentionCompliancePolicy
Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.
Use el New-AppRetentionCompliancePolicy para crear directivas de cumplimiento de retención de aplicaciones. Las directivas de etiquetado de retención & de aplicaciones tienen como destino nuevas formas de ámbito y administración de directivas.
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.
Syntax
New-AppRetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
-Applications <String[]>
[-Confirm]
[-Comment <String>]
[-Enabled <Boolean>]
[-Force]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] New-AppRetentionCompliancePolicy
[-Name] <String>
-Applications <String[]>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
Los cmdlets *-AppRetentionCompliance* se usan para directivas con ámbitos de directiva adaptables y todas las directivas estáticas que cubren canales privados de Teams, chats de Yammer y mensajes de la comunidad de Yammer. Finalmente, usará estos cmdlets para la mayoría de las ubicaciones de retención y los tipos de directiva. Los cmdlets *-RetentionCompliance* seguirán siendo compatibles con las ubicaciones de Exchange y SharePoint principalmente. En el caso de las directivas creadas con los cmdlets *-AppRetentionCompliance*, solo puede establecer la lista de ámbitos incluidos o excluidos para todas las cargas de trabajo incluidas, lo que significa que probablemente tendrá que crear una directiva por carga de trabajo.
Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams,Yammer","Group:MicrosoftTeams,Yammer" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"En este ejemplo se crea una directiva de retención de ámbito estático denominada Cumplimiento del Reglamento 567 para los mensajes de usuario de Yammer de Jennifer Petersen y Kitty Nakamura.
Después de crear la directiva de retención, use el cmdlet New-AppRetentionComplianceRule para crear una regla de retención y asignarle la directiva 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
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
El parámetro Applications especifica las aplicaciones que se incluirán en la directiva 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:Yammer".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocationException
El parámetro ExchangeLocationException especifica los buzones de correo que se excluyen 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
El parámetro Name especifica un nombre único para la directiva de cumplimiento de retención de aplicaciones. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 ni 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |