Set-ComplianceTag

Sintaxe

Default

Set-ComplianceTag
    [-Identity] <ComplianceRuleIdParameter>
    [-AutoApprovalPeriod <System.Int32>]
    [-Comment <String>]
    [-ComplianceTagForNextStage <String>]
    [-Confirm]
    [-EventType <ComplianceRuleIdParameter>]
    [-FilePlanProperty <String>]
    [-FlowId <System.Guid>]
    [-Force]
    [-MultiStageReviewProperty <String>]
    [-Notes <String>]
    [-RetentionDuration <Unlimited>]
    [-ReviewerEmail <SmtpAddress[]>]
    [-WhatIf]
    [<CommonParameters>]

PriorityCleanup

Set-ComplianceTag
    [-Identity] <ComplianceRuleIdParameter>
    [-PriorityCleanup]
    [-Comment <String>]
    [-Confirm]
    [-Force]
    [-MultiStageReviewProperty <String>]
    [-Notes <String>]
    [-RetentionDuration <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

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

Parâmetros

-AutoApprovalPeriod

Aplicável: Conformidade do & de Segurança

{{ Fill AutoApprovalPeriod Description }}

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Conformidade do & de Segurança

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

Propriedades do parâmetro

Conjuntos de parâmetros

-ComplianceTagForNextStage

Aplicável: Conformidade do & de Segurança

{{ Fill ComplianceTagForNextStage Description }}

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Conformidade do & de Segurança

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-EventType

Aplicável: Conformidade do & de Segurança

O EventType especifica a regra de retenção associada à etiqueta. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Você pode usar o cmdlet Get-RetentionComplianceRule para exibir as regras de retenção disponíveis.

Propriedades do parâmetro

Conjuntos de parâmetros

-FilePlanProperty

Aplicável: Conformidade do & de Segurança

O parâmetro FilePlanProperty especifica as propriedades do plano de ficheiros a incluir na etiqueta. Para ver os nomes de propriedade do plano de ficheiros que precisa de utilizar neste parâmetro, execute os seguintes comandos:

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

Um valor válido para este parâmetro envolve dois passos:

• Uma variável para armazenar as propriedades do plano de ficheiros como PSCustomObject com a seguinte sintaxe:

  $Variable1=[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 exemplo:

  $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"})}

• Uma segunda variável para converter o PSCustomObject num objeto JSON com a seguinte sintaxe:

  $Variable2 = ConvertTo-Json $Variable1

  Por exemplo:

  $fpStr = ConvertTo-Json $retentionLabelAction

Utilize a segunda variável como o valor para este parâmetro.

Propriedades do parâmetro

Conjuntos de parâmetros

-FlowId

Aplicável: Conformidade do & de Segurança

Nota: este parâmetro está atualmente em Pré-visualização, não está disponível em todas as organizações e está sujeito a alterações.

O parâmetro FlowId especifica o fluxo do Power Automate a ser executado no final do período de retenção. Um valor válido para este parâmetro é o valor GUID do fluxo.

Pode encontrar o valor GUID do fluxo através de um dos seguintes métodos:

• Navegue para o fluxo a partir do portal do Power Automate. O valor GUID do fluxo está no URL.
• Utilize a ação do Power Automate denominada "Listar fluxos como administrador".

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Aplicável: Conformidade do & de Segurança

O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Conformidade do & de Segurança

O parâmetro Identidade especifica a etiqueta que pretende modificar. É possível usar qualquer valor que identifique a marca com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

Propriedades do parâmetro

Conjuntos de parâmetros

-MultiStageReviewProperty

Aplicável: Conformidade do & de Segurança

O parâmetro MultiStageReviewProperty especifica as propriedades de revisão em várias fases a incluir na etiqueta. Esse parâmetro aceita a seguinte sintaxe:

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'

Por exemplo:

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'

Esta sintaxe é um objeto JSON que define cada ID da fase de revisão, o nome da fase de revisão e a lista de revisores.

Propriedades do parâmetro

Conjuntos de parâmetros

-Notes

Aplicável: Conformidade do & de Segurança

O parâmetro Notas especifica uma nota opcional. Se especificar um valor que contenha espaços, coloque o valor entre aspas ("), por exemplo: "Esta é uma nota de utilizador".

Propriedades do parâmetro

Conjuntos de parâmetros

-PriorityCleanup

Aplicável: Conformidade do & de Segurança

{{ Prioridade de PreenchimentoDesução do Preenchimento }}

Propriedades do parâmetro

Conjuntos de parâmetros

-RetentionDuration

Aplicável: Conformidade do & de Segurança

O parâmetro RetentionDuration especifica o número de dias para reter o conteúdo. Os valores válidos são:

• Um inteiro positivo.
• O valor unlimited.

Propriedades do parâmetro

Conjuntos de parâmetros

-ReviewerEmail

Aplicável: Conformidade do & de Segurança

O parâmetro ReviewerEmail especifica o endereço de email de um revisor para as ações de retenção Delete e KeepAndDelete. Você pode especificar vários endereços de email separados por vírgulas.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Conformidade do & de Segurança

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters