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..
Utilize o cmdlet Invoke-HoldRemovalAction para ver e remover suspensões em caixas de correio e sites do SharePoint. Também pode ver retenções que foram removidas anteriormente com este cmdlet.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
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. Apenas o Administrador de Conformidade pode remover a suspensão das localizações 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 remove a suspensã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 suspensão de casos ativa.
Exemplo 2
Invoke-HoldRemovalAction -Action GetHolds -SharePointLocation "https://contoso.sharepoint.com/sites/finance"
Este exemplo apresenta todas as informações de suspensão no site do SharePoint especificado.
Exemplo 3
Invoke-HoldRemovalAction -Action GetHoldRemovals
Este exemplo apresenta todas as remoção de suspensão que foram feitas com este cmdlet.
Parâmetros
-Action
Aplicável: Conformidade do & de Segurança
O parâmetro Ação especifica o modo em que o cmdlet funciona. Os valores válidos são:
- GetHoldRemovals: mostra todas as remoção de suspensão que foram feitas com este cmdlet.
- GetHolds: mostra retenções na caixa de correio especificada (o parâmetro ExchangeLocation) ou no site do SharePoint (o parâmetro SharePointLocation).
- RemoveHold: remove a suspensão especificada (o parâmetro HoldId) da caixa de correio especificada (o parâmetro ExchangeLocation) ou do site 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: Conformidade do & de Segurança
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.
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: Conformidade do & de Segurança
O parâmetro ExchangeLocation especifica o endereço de e-mail da caixa de correio que contém as suspensões para ver ou remover.
Este parâmetro é necessário quando utiliza o valor GetHolds ou RemoveHold para o parâmetro Ação.
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: Conformidade do & de Segurança
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Pode utilizar este comutador para forçar a remoção da suspensão mesmo quando a política está ativa. Em vez disso, deve remover a suspensão da política de suspensão do 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: Conformidade do & de Segurança
O parâmetro HoldId especifica a suspensão que pretende ver ou remover.
Para localizar valores válidos para este parâmetro, utilize este cmdlet com o valor do parâmetro 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: Conformidade do & de Segurança
O parâmetro SharePointLocation especifica o URL do site do SharePoint que contém as suspensões para ver ou remover.
Este parâmetro é necessário quando utiliza o valor GetHolds ou RemoveHold para o parâmetro Ação.
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: Conformidade do & de Segurança
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 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.