Release-QuarantineMessage
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Release-QuarantineMessage para liberar mensagens da quarentena em sua organização baseada em nuvem. Você pode liberar mensagens para todos os destinatários originais ou para destinatários específicos.
Para arquivos que foram colocados em quarentena por Anexos Seguros para SharePoint, OneDrive e Microsoft Teams, você pode desbloquear os arquivos nos respectivos sites de equipe e bibliotecas de documentos usando o cmdlet Release-QuarantineMessage para que os usuários possam acessar, compartilhar e baixar os arquivos.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Description
Considere o seguinte cenário: john@gmail.com envia uma mensagem para faith@contoso.com e john@subsidiary.contoso.com. O Gmail bifurca essa mensagem em duas cópias roteadas para quarentena como phishing na Microsoft. Um administrador libera essas duas mensagens para admin@contoso.com. A primeira mensagem lançada que chega à caixa de correio do administrador é entregue. A segunda mensagem lançada é identificada como entrega duplicada e é ignorada. serão identificados como duplicados se tiverem a mesma ID de mensagem e hora de recebimento.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.com
Este exemplo usa o cmdlet Get-QuarantineMessage para liberar a mensagem em quarentena com o valor <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID para um destinatário julia@contoso.comoriginal.
Exemplo 2
Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll
Este exemplo libera a mensagem em quarentena com o valor Identity especificado para todos os destinatários originais.
Exemplo 3
Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll
Este exemplo libera todas as mensagens para todos os destinatários originais.
Exemplo 4
$q = Get-QuarantineMessage -QuarantineTypes SPOMalware
$q[-1] | Release-QuarantineMessage -ReleaseToAll
Este exemplo libera um arquivo que foi colocado em quarentena como parte dos Anexos Seguros para SharePoint, OneDrive e Microsoft Teams. O primeiro comando armazena todos os arquivos em quarentena na variável $q. O segundo comando libera o último arquivo da lista. Para obter mais informações sobre elementos em matrizes e números de índice, consulte Acessando e usando elementos de matriz.
Parâmetros
-ActionType
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro ActionType especifica o tipo de ação de liberação. Os valores válidos são:
- Negar
- Liberação: use esse valor para liberar mensagens ou aprovar solicitações para liberar mensagens.
- Solicitação
Propriedades do parâmetro
| Tipo: | ReleaseActionType |
| 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 |
-AllowSender
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção AllowSender especifica que todas as mensagens futuras do remetente não serão colocadas em quarentena. Não é preciso especificar um valor com essa opção.
No entanto, se essa mensagem foi colocada em quarentena devido a uma regra de transporte ou a um remetente bloqueado, o remetente continuará sendo bloqueado para mensagens futuras.
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 |
-Confirm
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
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 |
-Force
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Use essa opção sempre que tentar liberar novamente mensagens lançadas anteriormente da quarentena.
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 |
-Identities
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Identities identifica mensagens em quarentena para operações em massa. Você identifica as mensagens usando a sintaxe: value1,value2,...valueN. O valor é um identificador de mensagem em quarentena exclusivo no formato GUID1\GUID2 (por exemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).
Você pode encontrar o valor de identidade de uma mensagem em quarentena usando o cmdlet Get-QuarantineMessage.
Quando você usa esse parâmetro, o parâmetro Identity é necessário, mas o valor é ignorado. Por exemplo, use o valor 000 para o parâmetro Identity.
Propriedades do parâmetro
| Tipo: | QuarantineMessageIdentity[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identities
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
OrgReleaseToAll
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
OrgReleaseToUser
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro Identity especifica a mensagem em quarentena que você deseja liberar. O valor é um identificador de mensagem em quarentena exclusivo no formato GUID1\GUID2 (por exemplo c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7).
Para encontrar o valor Identity de uma mensagem em quarentena, use o cmdlet Get-QuarantineMessage.
Propriedades do parâmetro
| Tipo: | QuarantineMessageIdentity |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identities
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
OrgReleaseToAll
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
OrgReleaseToUser
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
IdentityOnly
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ReleaseToAll
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção ReleaseToAll libera a mensagem em quarentena para todos os destinatários originais. Não é preciso especificar um valor com essa opção.
Essa opção é necessária para o tipo de quarentena SPOMalware.
Se você tiver usado anteriormente o parâmetro User ou a opção ReleaseToAll para liberar a mensagem em quarentena para alguns ou todos os destinatários originais, esses destinatários serão ignorados quando você usar a opção ReleaseToAll novamente.
Não é possível usar a opção ReleaseToAll e o parâmetro User no mesmo comando.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OrgReleaseToAll
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReportFalsePositive
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
A opção ReportFalsePositive especifica se a mensagem deve ser relatada como um falso positivo para a Microsoft (mensagem boa marcada como ruim). Não é preciso especificar um valor com essa opção.
Esta opção está disponível apenas para mensagens de spam em quarentena.
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 |
-User
Aplicável: Exchange Online, Segurança & Conformidade, Complemento de segurança integrado para caixas de correio locais
O parâmetro User especifica o endereço de email do usuário para o qual você deseja liberar a mensagem em quarentena. Você pode especificar vários endereços de email separados por vírgulas.
Você pode usar esse parâmetro para liberar a mensagem para os destinatários da mensagem original ou para qualquer outro endereço de email na organização.
Se anteriormente você tiver usado a opção ReleaseToAll para liberar a mensagem em quarentena para todos os destinatários originais e depois liberou a mensagem novamente com o parâmetro User, qualquer destinatário original especificado com o User será ignorado.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OrgReleaseToUser
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 |
| 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.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.