Release-QuarantineMessage

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Security & Compliance, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Utilizzare il cmdlet Release-QuarantineMessage per rilasciare i messaggi dalla quarantena nell'organizzazione basata su cloud. È possibile rilasciare messaggi a tutti i destinatari originali o a destinatari specifici.

Per i file messi in quarantena da Allegati sicuri per SharePoint, OneDrive e Microsoft Teams, è possibile sbloccare i file nei rispettivi siti del team e nelle raccolte documenti usando il cmdlet Release-QuarantineMessage in modo che gli utenti possano accedere, condividere e scaricare i file.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Release-QuarantineMessage
       -User <String[]>
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-ReleaseToAll]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       -Identities <QuarantineMessageIdentity[]>
       [-Identity <QuarantineMessageIdentity>]
       [-ActionType <ReleaseActionType>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]
Release-QuarantineMessage
       -Identity <QuarantineMessageIdentity>
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Descrizione

Si consideri lo scenario seguente: john@gmail.com invia un messaggio a faith@contoso.com e john@subsidiary.contoso.com. Gmail biforcates this message into two copies that are both routingd to quarantine as phishing in Microsoft. Un amministratore rilascia entrambi questi messaggi in admin@contoso.com. Viene recapitato il primo messaggio rilasciato che raggiunge la cassetta postale di amministrazione. Il secondo messaggio rilasciato viene identificato come recapito duplicato e viene ignorato. I messaggi vengono identificati come duplicati se hanno lo stesso ID messaggio e l'ora di ricezione.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>" | Release-QuarantineMessage -User julia@contoso.com

In questo esempio viene usato il cmdlet Get-QuarantineMessage per rilasciare il messaggio in quarantena con il valore <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID a un destinatario julia@contoso.comoriginale.

Esempio 2

Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll

In questo esempio viene rilasciato il messaggio in quarantena con il valore Identity specificato a tutti i destinatari originali.

Esempio 3

Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll

In questo esempio vengono rilasciati tutti i messaggi a tutti i destinatari originali.

Esempio 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

$q[-1] | Release-QuarantineMessage -ReleaseToAll

In questo esempio viene rilasciato un file messo in quarantena come parte di Allegati sicuri per SharePoint, OneDrive e Microsoft Teams. Il primo comando archivia tutti i file in quarantena nella variabile $q. Il secondo comando rilascia l'ultimo file nell'elenco. Per altre informazioni sugli elementi nelle matrici e nei numeri di indice, vedere Accesso e uso di elementi della matrice.

Parametri

-ActionType

Il parametro ActionType specifica il tipo di azione di rilascio. I valori validi sono:

  • Approva
  • Nega
  • Rilascio
  • Richiesta
Type:ReleaseActionType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-AllowSender

L'opzione AllowSender consente di specificare che tutti i messaggi futuri proveniente dal mittente non verranno messi in quarantena. Con questa opzione non è necessario specificare alcun valore.

Se il messaggio è stato messo in quarantena a causa di una regola di trasporto o di un mittente bloccato, i messaggi provenienti dal mittente potranno essere bloccati in futuro.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

Il parametro EntityType filtra i risultati in base a EntityType. I valori validi sono:

  • Posta elettronica
  • SharePointOnline
  • Teams (attualmente in anteprima)
Type:Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Force

L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

Usare questa opzione ogni volta che si tenta di rilasciare nuovamente i messaggi rilasciati in precedenza dalla quarantena.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

Il parametro Identities identifica i messaggi in quarantena per le operazioni bulk. Per identificare i messaggi, usare la sintassi : value1,value2,...valueN. Il valore è un identificatore univoco del messaggio in quarantena nel formato GUID1\GUID2 , ad esempio c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7.

È possibile trovare il valore identity per un messaggio in quarantena usando il cmdlet Get-QuarantineMessage.

Quando si usa questo parametro, il parametro Identity è obbligatorio, ma il valore viene ignorato. Ad esempio, usare il valore 000 per il parametro Identity.

Type:QuarantineMessageIdentity[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare il messaggio in quarantena che si desidera rilasciare. Il valore è un identificatore univoco del messaggio in quarantena nel formato GUID1\GUID2 , ad esempio c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7.

È possibile trovare il valore Identity per un messaggio in quarantena utilizzando il cmdlet Get-QuarantineMessage.

Type:QuarantineMessageIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ReleaseToAll

L'opzione ReleaseToAll consente di recapitare il messaggio in quarantena a tutti i destinatari originali. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è necessaria per il tipo di quarantena SPOMalware.

Se in precedenza è stato usato il parametro User o l'opzione ReleaseToAll per rilasciare il messaggio in quarantena ad alcuni o a tutti i destinatari originali, tali destinatari vengono ignorati quando si usa nuovamente l'opzione ReleaseToAll.

Non è possibile utilizzare l'opzione ReleaseToAll e il parametro User nello stesso comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

L'opzione ReportFalsePositive specifica se segnalare il messaggio come falso positivo a Microsoft (messaggio valido contrassegnato come non valido). Con questa opzione non è necessario specificare alcun valore.

Questa opzione è disponibile solo per i messaggi di posta indesiderata in quarantena.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-User

Il parametro User consente di specificare l'indirizzo di posta elettronica dell'utente al quale recapitare il messaggio in quarantena. È possibile indicare più indirizzi di posta elettronica separati da virgole.

È possibile usare questo parametro per rilasciare il messaggio ai destinatari del messaggio originale o a qualsiasi altro indirizzo di posta elettronica nell'organizzazione.

Se precedentemente era stata utilizzata l'opzione ReleaseToAll per recapitare il messaggio in quarantena a tutti i destinatari originali, in seguito sarà necessario recapitare nuovamente il messaggio con il parametro User, in questo modo eventuali destinatari originali specificati con il parametro User verranno saltati.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.