Set-RetentionCompliancePolicy

Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet Set-RetentionCompliancePolicy para modificar las directivas de retención existentes en el portal de cumplimiento Microsoft Purview.

Nota: La ejecución de este cmdlet provoca una sincronización completa en toda la organización, lo cual es una operación importante. Si necesita actualizar varias directivas, espere hasta que la distribución de directivas sea correcta antes de volver a ejecutar el cmdlet para la siguiente directiva. Para obtener información sobre el estado de distribución, vea Get-RetentionCompliancePolicy.

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

Identity

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-AddOneDriveLocation <MultiValuedProperty>]
    [-AddOneDriveLocationException <MultiValuedProperty>]
    [-AddPublicFolderLocation <MultiValuedProperty>]
    [-AddSharePointLocation <MultiValuedProperty>]
    [-AddSharePointLocationException <MultiValuedProperty>]
    [-AddSkypeLocation <MultiValuedProperty>]
    [-AddSkypeLocationException <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RemoveOneDriveLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocationException <MultiValuedProperty>]
    [-RemovePublicFolderLocation <MultiValuedProperty>]
    [-RemoveSharePointLocation <MultiValuedProperty>]
    [-RemoveSharePointLocationException <MultiValuedProperty>]
    [-RemoveSkypeLocation <MultiValuedProperty>]
    [-RemoveSkypeLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

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

RetryDistribution

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-RetryDistribution]
    [-Confirm]
    [-DeletedResources <String>]
    [-EnforceSimulationPolicy <Boolean>]
    [-PriorityCleanup]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddTeamsChannelLocation <MultiValuedProperty>]
    [-AddTeamsChannelLocationException <MultiValuedProperty>]
    [-AddTeamsChatLocation <MultiValuedProperty>]
    [-AddTeamsChatLocationException <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveTeamsChannelLocation <MultiValuedProperty>]
    [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
    [-RemoveTeamsChatLocation <MultiValuedProperty>]
    [-RemoveTeamsChatLocationException <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-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.

Nota: No use un comando de Foreach-Object canalizado al agregar o quitar ubicaciones de ámbito: "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.

Ejemplos

Ejemplo 1

Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"

En este ejemplo se realizan los siguientes cambios en la directiva de retención existente denominada "Regulation 123 Compliance":

  • Se agrega el buzón para el usuario cuyo nombre es Kitty Petersen.
  • Agrega el sitio https://contoso.sharepoint.com/sites/teams/financede SharePoint.
  • Quita las carpetas públicas.
  • Se actualiza el comentario.

Ejemplo 2

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

En el ejemplo se quita el grupo y el sitio de Microsoft 365 eliminados especificados de la directiva especificada. Identifique los recursos eliminados mediante la dirección de correo electrónico del grupo de Microsoft 365 y el identificador del sitio relacionado.

IMPORTANTE: Antes de ejecutar este comando, asegúrese de leer la información de precaución para el parámetro DeletedResources sobre direcciones SMTP duplicadas.

Ejemplo 3

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

En el ejemplo se excluye el grupo y el sitio de Microsoft 365 eliminados especificados de la directiva de nivel de inquilino especificada. Identifique los recursos eliminados mediante la dirección de correo electrónico del grupo de Microsoft 365 y el identificador del sitio relacionado.

IMPORTANTE: Antes de ejecutar este comando, asegúrese de leer la información de precaución para el parámetro DeletedResources sobre direcciones SMTP duplicadas.

Ejemplo 4

$stringJson = @"
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
 },
{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Este ejemplo es similar al Ejemplo 2, excepto que se especifican varios recursos eliminados.

IMPORTANTE: Antes de ejecutar este comando, asegúrese de leer la información de precaución para el parámetro DeletedResources sobre direcciones SMTP duplicadas.

Ejemplo 5

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

En este ejemplo se excluye el buzón eliminado de forma temporal especificado o el usuario de correo de la directiva de retención de Teams mencionada. Puede identificar los recursos eliminados mediante el buzón o la dirección de correo electrónico del usuario.

IMPORTANTE: Antes de ejecutar este comando, asegúrese de leer la información de precaución para el parámetro DeletedResources sobre direcciones SMTP duplicadas.

Ejemplo 6

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Este ejemplo es similar al Ejemplo 5, excepto que se especifican varios recursos eliminados.

IMPORTANTE: Antes de ejecutar este comando, asegúrese de leer la información de precaución para el parámetro DeletedResources sobre direcciones SMTP duplicadas.

Las exclusiones de directivas deben permanecer dentro de los límites admitidos para las directivas de retención: Límites de las directivas de retención de Microsoft 365 y las directivas de etiquetas de retención

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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AdaptiveScopeLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddExchangeLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los buzones que se agregarán a la lista de buzones excluidos cuando se utilice 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddOneDriveLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddOneDriveLocation especifica los sitios de OneDrive que se agregarán a la lista de sitios incluidos cuando no se use el valor Todos para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddOneDriveLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de OneDrive que se agregarán a la lista de sitios excluidos cuando se usa el valor Todos para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddPublicFolderLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddPublicFolderLocation especifica que desea agregar todas las carpetas públicas a la directiva de retención. Use el valor All para este parámetro.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddSharePointLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddSharePointLocation especifica los sitios de SharePoint que se agregarán a la lista de sitios incluidos cuando no se use el valor Todos para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

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

Los sitios de SharePoint no se pueden agregar a la directiva hasta que se hayan indexado.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddSharePointLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de SharePoint que se agregarán a la lista de sitios excluidos cuando se use el valor Todos para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddSkypeLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddSkypeLocation especifica los usuarios de Skype Empresarial Online que se agregarán de la lista de usuarios incluidos de Skype Empresarial Online.

Puede usar cualquier valor que identifique el usuario de forma exclusiva. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddSkypeLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddTeamsChannelLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddTeamsChannelLocation especifica los equipos que se agregarán a la directiva.

Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddTeamsChannelLocationException

Aplicable: Seguridad & cumplimiento

El parámetro AddTeamsChannelLocationException especifica los equipos que se agregarán a la lista de exclusión cuando se usa el valor Todos para el parámetro TeamsChannelLocation. Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddTeamsChatLocation

Aplicable: Seguridad & cumplimiento

El parámetro AddTeamsChatLocation especifica los usuarios de Teams que se agregarán a la directiva.

Puede usar cualquier valor que identifique el usuario de forma exclusiva. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AddTeamsChatLocationException

Aplicable: Seguridad & cumplimiento

El parámetro AddTeamsChatLocationException especifica los usuarios de Teams que se agregarán a la lista de exclusión cuando se usa el valor Todos para el parámetro TeamsChatLocation. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Applications

Aplicable: Seguridad & cumplimiento

El parámetro Applications especifica el destino cuando se incluyen Grupos de Microsoft 365 en la directiva (se establece el parámetro ModernGroups). Los valores admitidos son:

  • Group:Exchange para el buzón que está conectado al grupo de Microsoft 365.
  • Group:SharePoint para el sitio de SharePoint que está conectado al grupo de Microsoft 365.
  • "Group:Exchange,SharePoint" tanto para el buzón como para el sitio de SharePoint que están conectados al grupo de Microsoft 365.
  • blank ($null): Este valor es el predeterminado y es funcionalmente equivalente al valor "Group:Exchange,SharePoint". Para volver al valor predeterminado del buzón y del sitio de SharePoint para los grupos de Microsoft 365 seleccionados, especifique "Group:Exchange,SharePoint".

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DeletedResources

Aplicable: Seguridad & cumplimiento

El parámetro DeletedResources especifica el grupo, buzón o usuario de correo de Microsoft 365 eliminado que se va a quitar o agregar como exclusión a la lista de ubicaciones respectiva. Use este parámetro con los parámetros AddModernGroupLocationException y RemoveModernGroupLocation para Grupos de Microsoft 365 eliminados, o con el parámetro AddTeamsChatLocationException para buzones eliminados o usuarios de correo.

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.

PRECAUCIÓN: Cuando utilice una dirección SMTP con este parámetro, tenga en cuenta que la misma dirección podría usarse también para otros buzones o usuarios de correo. 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.

Para obtener más información sobre el escenario eliminado de un grupo de Microsoft 365, consulte Más información sobre la eliminación de grupos modernos en suspensión de retención.

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Enabled

Aplicable: Seguridad & cumplimiento

El parámetro Enabled especifica si la directiva está habilitada. 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

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnforceSimulationPolicy

Aplicable: Seguridad & cumplimiento

El parámetro EnforceSimulationPolicy especifica si se aplicará una directiva de simulación como una directiva activa. Los valores admitidos son:

  • $true: Aplicar la directiva de simulación como una directiva activa.
  • $false: No aplique la directiva de simulación como una directiva activa. Este valor es el predeterminado.

Para obtener más información sobre el modo de simulación, consulte Más información sobre el modo de simulación.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Seguridad & cumplimiento

El parámetro Identity especifica la directiva de retención 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

Tipo:PolicyIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PolicyTemplateInfo

Aplicable: Seguridad & cumplimiento

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:PswsHashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PriorityCleanup

Aplicable: Seguridad & cumplimiento

El modificador PriorityCleanup especifica si se va a actualizar una directiva de limpieza de prioridad. No es necesario especificar un valor con este modificador.

Las directivas de limpieza de prioridad aceleran la eliminación de contenido confidencial reemplazando cualquier configuración de retención existente o suspensiones de exhibición de documentos electrónicos. Para obtener más información, vea Limpieza de prioridad.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AdaptiveScopeLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

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

Es posible usar cualquier valor que identifique exclusivamente el buzón. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

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

Es posible usar cualquier valor que identifique exclusivamente el buzón. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveOneDriveLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemoveOneDriveLocation especifica los sitios de OneDrive que se quitarán de la lista de sitios incluidos cuando no se use el valor Todos para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveOneDriveLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de OneDrive que se quitarán de la lista de sitios excluidos al usar el valor Todos para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemovePublicFolderLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemovePublicFolderLocation especifica que desea quitar todas las carpetas públicas de la directiva de retención. Use el valor All para este parámetro.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveSharePointLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemoveSharePointLocation especifica los sitios de SharePoint que se quitarán de la lista de sitios incluidos cuando no se use el valor Todos para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveSharePointLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro especifica los sitios de SharePoint que se quitarán de la lista de sitios excluidos cuando se usa el valor Todos para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveSkypeLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemoveSkypeLocation especifica los usuarios de Skype Empresarial Online que se deben quitar de la lista de usuarios incluidos de Skype Empresarial Online.

Puede usar cualquier valor que identifique el usuario de forma exclusiva. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveSkypeLocationException

Aplicable: Seguridad & cumplimiento

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveTeamsChannelLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemoveTeamsChannelLocation especifica los equipos que se quitarán de la directiva.

Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveTeamsChannelLocationException

Aplicable: Seguridad & cumplimiento

El parámetro RemoveTeamsChannelLocationException especifica los equipos que se quitarán de la lista de exclusión cuando se usa el valor Todos para el parámetro TeamsChannelLocation. Puede usar cualquier valor que identifique de forma única al equipo. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveTeamsChatLocation

Aplicable: Seguridad & cumplimiento

El parámetro RemoveTeamsChatLocation especifica los usuarios de Teams que se deben quitar de la directiva.

Puede usar cualquier valor que identifique el usuario de forma exclusiva. 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

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveTeamsChatLocationException

Aplicable: Seguridad & cumplimiento

El parámetro RemoveTeamsChatLocationException especifica los usuarios de Teams que se quitarán de la lista de exclusión cuando se usa el valor Todos para el parámetro TeamsChatLocation. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:

  • Nombre
  • Dirección de correo electrónico
  • GUID

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

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TeamLocation
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RestrictiveRetention

Aplicable: Seguridad & cumplimiento

El parámetro RestrictiveRetention especifica si el bloqueo de conservación está habilitado para una directiva de retención o una directiva de etiquetas de retención. 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 o quitar contenido de la directiva. Además, no es posible modificar ni eliminar el contenido que está sujeto a la directiva durante el período de retención. La única manera de modificar la directiva de retención es agregándole contenido 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 para la retención, 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

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RetryDistribution

Aplicable: Seguridad & cumplimiento

El modificador RetryDistribution especifica si se va a redistribuir la directiva a todas las ubicaciones de Exchange Online y SharePoint. 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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RetryDistribution
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StartSimulation

Aplicable: Seguridad & cumplimiento

El parámetro StartSimulation especifica si se debe iniciar la simulación de una directiva que se creó en modo de simulación. Los valores admitidos son:

  • $true: Inicia la simulación.
  • $false: No inicie la simulación. Este valor es el predeterminado.

Para obtener más información sobre el modo de simulación, consulte Más información sobre el modo de simulación.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Seguridad & cumplimiento

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.