Compartilhar via


Get-CaseHoldPolicy

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-CaseHoldPolicy para ver as políticas de suspensão de incidentes existentes no portal de conformidade do Microsoft Purview. Para obter informações relevantes sobre como a suspensão foi aplicada e as localizações afetadas, tem de incluir o comutador DistributionDetail.

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

Sintaxe

Default (Default)

Get-CaseHoldPolicy
    [[-Identity] <PolicyIdParameter>]
    [-Case <String>]
    [-DistributionDetail]
    [-IncludeBindings]
    [-IncludeBindingsOnly]
    [<CommonParameters>]

Description

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-CaseHoldPolicy -Case "Contoso Legal"

Este exemplo traz informações detalhadas para a política que está associada ao caso de Descoberta Eletrônica chamado Jurídico da Contoso.

Exemplo 2

Get-CaseHoldPolicy -Identity "Regulation 123 Compliance"

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

Parâmetros

-Case

Aplicável: Conformidade do & de Segurança

O parâmetro Case especifica a política de boqueio de caso que você deseja exibir usando o caso de Descoberta Eletrônica que está associado à política. Você pode usar os seguintes valores para identificar o caso de Descoberta Eletrônica:

  • Nome
  • Identidade (valor GUID)

Você encontra esses valores executando o comando Get-ComplianceCase | Format-Table -Auto Name,Status,Identity

Propriedades do parâmetro

Tipo:String
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

-DistributionDetail

Aplicável: Conformidade do & de Segurança

O comutador DistributionDetail devolve informações detalhadas sobre a distribuição de políticas na política de suspensão de casos. Não é preciso especificar um valor com essa opção.

Se não utilizar este comutador, o comando não devolve informações sobre a implementação atual status e a propriedade DistributionStatus é apresentada como "Pendente".

As seguintes propriedades são afetadas por este comutador:

  • SharePointLocation
  • ExchangeLocation
  • PublicFolderLocation
  • DistributionStatus
  • DistributionResults
  • LastStatusUpdateTime

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 bloqueio de caso 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

-IncludeBindings

Aplicável: Conformidade do & de Segurança

PARAMVALUE: SwitchParameter

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

-IncludeBindingsOnly

Aplicável: Conformidade do & de Segurança

{{ Fill IncludeBindingsOnly Description }}

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

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.