Invoke-HoldRemovalAction
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 o cmdlet Invoke-HoldRemovalAction para exibir e remover retenções em caixas de correio e sites do SharePoint. Você também pode ver as retenções que foram removidas anteriormente usando este cmdlet.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Invoke-HoldRemovalAction
-Action <HoldRemovalActionType>
[-Confirm]
[-ExchangeLocation <String>]
[-Force]
[-HoldId <String>]
[-SharePointLocation <String>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Somente o Administrador de Conformidade pode remover a retenção para locais do Exchange ou do SharePoint. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Invoke-HoldRemovalAction -Action RemoveHold -ExchangeLocation "KittyPetersen@contoso.onmicrosoft.com" -HoldId "UniHecbf89df-74fc-444a-a2dc-c0756c7d3503"
Este exemplo removerá a retenção especificada na caixa de correio de Kitty Petersen se a política UniHecbf89df-74fc-444a-a2dc-c0756c7d3503 não for uma política de retenção de caso ativo.
Exemplo 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
Este exemplo exibe todas as informações de retenção no site especificado do SharePoint.
Exemplo 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
Este exemplo exibe todas as remoções de retenção que foram feitas usando esse cmdlet.
Parâmetros
-Action
Aplicável: Segurança & Conformidade
O parâmetro Action especifica o modo no qual o cmdlet opera. Os valores válidos são:
- GetHoldRemovals: mostra todas as remoções de retenção que foram feitas usando esse cmdlet.
- GetHolds: mostra as retenções na caixa de correio especificada (o parâmetro ExchangeLocation) ou no site do SharePoint (o parâmetro SharePointLocation).
- RemoveHold: remove a retenção especificada (o parâmetro HoldId) da caixa de correio especificada (o parâmetro ExchangeLocation) ou do site do SharePoint (o parâmetro SharePointLocation).
Propriedades do parâmetro
| Tipo: | HoldRemovalActionType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Segurança & Conformidade
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-ExchangeLocation
Aplicável: Segurança & Conformidade
O parâmetro ExchangeLocation especifica o endereço de email da caixa de correio que contém as retenções a serem exibidas ou removidas.
Esse parâmetro é necessário quando você usa o valor GetHolds ou RemoveHold para o parâmetro Action.
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 |
-Force
Aplicável: Segurança & Conformidade
A opção 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 forçar a remoção da retenção mesmo quando a política estiver ativa. Em vez disso, você deve remover a retenção da política de retenção de caso.
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 |
-HoldId
Aplicável: Segurança & Conformidade
O parâmetro HoldId especifica a retenção que você deseja exibir ou remover.
Para encontrar valores válidos para esse parâmetro, use este cmdlet com o valor do parâmetro de ação GetHolds e procure a propriedade HoldId na saída.
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 |
-SharePointLocation
Aplicável: Segurança & Conformidade
O parâmetro SharePointLocation especifica a URL do site do SharePoint que contém as guardas de documentos a serem exibidas ou removidas.
Esse parâmetro é necessário quando você usa o valor GetHolds ou RemoveHold para o parâmetro Action.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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 |
-WhatIf
Aplicável: Segurança & Conformidade
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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.