Set-ComplianceTag

Este cmdlet solo está disponible en PowerShell del centro de cumplimiento de & de seguridad. Para obtener más información, vea PowerShell del centro de cumplimiento de & de seguridad.

Use el cmdlet Set-ComplianceTag para modificar etiquetas en el centro de seguridad & cumplimiento.

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

Set-ComplianceTag
   [-Identity] <ComplianceRuleIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-EventType <ComplianceRuleIdParameter>]
   [-FilePlanProperty <String>]
   [-Force]
   [-Notes <String>]
   [-RetentionDuration <Unlimited>]
   [-ReviewerEmail <SmtpAddress[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Debe tener asignados permisos en el centro de seguridad & cumplimiento antes de poder usar este cmdlet. Para obtener más información, vea Permisos en el Centro de seguridad y cumplimiento.

Ejemplos

Ejemplo 1

Set-ComplianceTag -Identity "HR Content" -RetentionDuration 2555 -Comment "Retain HR content for 7 years"

En este ejemplo se modifica la etiqueta existente denominada HR Content modificando la duración de retención y agregando un comentario.

Parámetros

-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-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 la solicitud de confirmación con 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-EventType

EventType especifica la regla de retención asociada a la etiqueta. Puede usar cualquier valor que identifique de forma exclusiva la regla. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Puede usar el cmdlet Get-RetentionComplianceRule para ver las reglas de retención disponibles.

Type:ComplianceRuleIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-FilePlanProperty

El parámetro FilePlanProperty especifica las propiedades del plan de archivos que se van a incluir en la etiqueta. Para ver los nombres de propiedad del plan de archivos que necesita usar en este parámetro, ejecute los siguientes comandos:

  • Get-FilePlanPropertyAuthority | Nombre de Format-List
  • Get-FilePlanPropertyCategory | Nombre de Format-List
  • Get-FilePlanPropertyCitation | Nombre de Format-List
  • Get-FilePlanPropertyDepartment | Nombre de Format-List
  • Get-FilePlanPropertyReferenceId | Nombre de Format-List
  • Get-FilePlanPropertySubCategory | Nombre de Format-List

Un valor válido para este parámetro implica dos pasos:

  • Una variable para almacenar las propiedades del plan de archivos como PSCustomObject con la siguiente sintaxis:

    $Variable 1 = [PSCustomObject] @ {Settings = @ (@ {key = "FilePlanPropertyDepartment"; Value = "Name"}, @ {Key = "FilePlanPropertyCategory"; Value = "Name"}, @ {Key = "FilePlanPropertySubcategory"; Value = "Name"}, @ {Key = "FilePlanPropertyCitation"; Value = "Name"}, @ {Key = "FilePlanPropertyReferenceId"; Value = "Name"}, @ {Key = "FilePlanPropertyAuthority"; Value = "Name"})}

    Por ejemplo:

    $retentionLabelAction = [PSCustomObject] @ {Settings = @ (@ {key = "FilePlanPropertyDepartment"; Value = "legal"}, @ {Key = "FilePlanPropertyCategory"; Value = "Tax"}, @ {Key = "FilePlanPropertySubcategory"; Value = "US_Tax"}, @ {Key = "FilePlanPropertyCitation"; Value = "LegalCitation"}, @ {Key = "FilePlanPropertyReferenceId"; Value = "Referencea"}, @ {Key = "FilePlanPropertyAuthority"; Value = "Auth1"})}

  • Una segunda variable para convertir PSCustomObject en un objeto JSON mediante la siguiente sintaxis:

    $Variable 2 = ConvertTo-Json $Variable 1

    Por ejemplo:

    $fpStr = ConvertTo-Json $retentionLabelAction

La segunda variable se usa como el valor de este parámetro.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Force

El modificador Force especifica si se van a suprimir los mensajes de advertencia o confirmación. Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Identity

El parámetro Identity especifica la etiqueta que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la etiqueta. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:ComplianceRuleIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance Center
-Notas

El parámetro Notes especifica una nota opcional. Si especifica un valor que contiene espacios, escriba el valor entre comillas ("), por ejemplo:" Esto es una nota de usuario ".

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-RetentionDuration

El parámetro RetentionDuration especifica la cantidad de días que se va a conservar el contenido. Los valores válidos son:

  • Un número entero positivo.
  • El valor unlimited.
Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-ReviewerEmail

El parámetro ReviewerEmail especifica la dirección de correo electrónico del revisor para las acciones de retención Delete y KeepAndDelete. Puede especificar varias direcciones de correo electrónico separadas por comas.

Type:SmtpAddress[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center
-WhatIf

El modificador WhatIf no funciona en PowerShell del centro de cumplimiento de & de seguridad.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance Center

Entradas

Salidas