Compartir a través de


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