Release-QuarantineMessage
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 inviare 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 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
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>]
Descrizione
Si consideri lo scenario seguente: john@gmail.com invia un messaggio a faith@contoso.com e john@subsidiary.contoso.com. Gmail biforca questo messaggio in due copie, entrambe instradate in quarantena come phishing in Microsoft. Un amministratore rilascia entrambi questi messaggi a admin@contoso.com. Il primo messaggio rilasciato che raggiunge la cassetta postale dell'amministratore viene recapitato. 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 lo stesso orario di ricezione.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 utilizzato 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 degli allegati sicuri per SharePoint, OneDrive e Microsoft Teams. Il primo comando memorizza tutti i file in quarantena nel $q variabile. Il secondo comando rilascia l'ultimo file dell'elenco. Per ulteriori informazioni sugli elementi nelle matrici e nei numeri di indice, vedere Accesso e utilizzo degli elementi delle matrici.
Parametri
-ActionType
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro ActionType consente di specificare il tipo di azione di rilascio. I valori validi sono:
- Nega
- Rilascio: usare questo valore per rilasciare i messaggi o approvare le richieste di rilascio dei messaggi.
- Richiesta
Proprietà dei parametri
| Tipo: | ReleaseActionType |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AllowSender
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione AllowSender specifica che tutti i messaggi futuri del mittente non vengono 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
L'interruttore di 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identities
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Il parametro Identities identifica i messaggi in quarantena per le operazioni in blocco. I messaggi vengono identificati mediante la sintassi seguente: 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 di identità per un messaggio in quarantena usando il cmdlet Get-QuarantineMessage.
Quando si utilizza questo parametro, il parametro Identity è obbligatorio, ma il valore viene ignorato. Ad esempio, utilizza il valore 000 per il parametro Identity.
Proprietà dei parametri
| Tipo: | QuarantineMessageIdentity[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identities
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
OrgReleaseToAll
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
OrgReleaseToUser
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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.
Proprietà dei parametri
| Tipo: | QuarantineMessageIdentity |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identities
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
OrgReleaseToAll
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
OrgReleaseToUser
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
IdentityOnly
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ReleaseToAll
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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 utilizza nuovamente l'opzione ReleaseToAll.
Non è possibile utilizzare l'opzione ReleaseToAll e il parametro User nello stesso comando.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
OrgReleaseToAll
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ReportFalsePositive
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-User
Applicabile: Exchange Online, sicurezza & conformità, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
OrgReleaseToUser
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.