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..
Use a Get-CaseHoldPolicy para exibir as políticas de retenção de ocorrência existentes no portal de conformidade do Microsoft Purview. Para obter informações relevantes sobre como a retenção foi aplicada e os locais afetados, você precisa incluir a opção 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: Segurança & Conformidade
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: Segurança & Conformidade
O comutador DistributionDetail retorna informações detalhadas de distribuição de política sobre a política de retenção de caso. Não é preciso especificar um valor com essa opção.
Se você não usar essa opção, o comando não retornará informações sobre o status de implantação atual e a propriedade DistributionStatus será exibida como "Pendente".
As seguintes propriedades são afetadas por essa opção:
- 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: Segurança & Conformidade
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
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas 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: Segurança & Conformidade
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: Segurança & Conformidade
{{ 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.