Set-ComplianceTag
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Utilize o cmdlet Set-ComplianceTag para modificar as etiquetas de retenção no portal de conformidade do Microsoft Purview. As etiquetas de retenção aplicam definições de retenção ao conteúdo.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
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>]
Set-ComplianceTag
[-Identity] <ComplianceRuleIdParameter>
[-PriorityCleanup]
[-Comment <String>]
[-Confirm]
[-Force]
[-MultiStageReviewProperty <String>]
[-Notes <String>]
[-RetentionDuration <Unlimited>]
[-WhatIf]
[<CommonParameters>]
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Set-ComplianceTag -Identity "HR Content" -RetentionDuration 2555 -Comment "Retain HR content for 7 years"
Este exemplo modifica o rótulo existente denominado Conteúdo de RH modificando a duração de retenção e adicionando um comentário.
{{ Fill AutoApprovalPeriod Description }}
Tipo: | System.Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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”.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
{{ Fill ComplianceTagForNextStage Description }}
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | ComplianceRuleIdParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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="Referen
ceA"},@{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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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".
Tipo: | System.Guid |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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
Tipo: | ComplianceRuleIdParameter |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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".
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
{{ Prioridade de PreenchimentoDesução do Preenchimento }}
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | Unlimited |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
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.
Tipo: | SmtpAddress[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Security & Compliance |