Partilhar via


Get-HoldCompliancePolicy

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 Get-HoldCompliancePolicy para ver as políticas de preservação existentes no portal de conformidade do Microsoft Purview.

Nota: o cmdlet Get-HoldCompliancePolicy é substituído pelo cmdlet Get-RetentionCompliancePolicy. Se tiver scripts que utilizam Get-HoldCompliancePolicy, atualize-os para utilizar Get-RetentionCompliancePolicy.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default)

Get-HoldCompliancePolicy
    [[-Identity] <PolicyIdParameter>]
    [-DistributionDetail]
    [<CommonParameters>]

Description

Esta lista descreve as propriedades exibidas por padrão.

  • Nome: o nome exclusivo da política.
  • Carga de trabalho: onde a política é aplicada. Por exemplo, o SharePoint ou o Exchange.
  • Ativado: o valor Verdadeiro significa que a política está ativada.
  • Modo: o modo de funcionamento atual da política. Os valores possíveis são Test (o conteúdo é testado, mas não são impostas regras), AuditAndNotify (quando o conteúdo corresponde às condições especificadas pela política, a regra não é imposta, mas os e-mails de notificação são enviados) ou Impor (todos os aspetos da política são ativados e impostos).

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.

Exemplos

Exemplo 1

Get-HoldCompliancePolicy

Este exemplo exibe informações de resumo de todas as políticas de preservação em sua organização.

Exemplo 2

Get-HoldCompliancePolicy -Identity "Regulation 123 Compliance" | Format-List

Este exemplo exibe informações detalhadas sobre a política chamada "Regulamentação de conformidade 123".

Parâmetros

-DistributionDetail

Aplicável: Conformidade do & de Segurança

A opção DistributionDetail retorna informações detalhadas de distribuição de políticas na propriedade DistributionResults. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Conformidade do & de Segurança

O parâmetro Identity especifica a política de preservação que você deseja exibir. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:PolicyIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.