Set-QuarantinePolicy
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet Set-QuarantinePolicy per modificare i criteri di quarantena nell'organizzazione basata sul cloud.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-QuarantinePolicy
[-Identity] <QuarantineTagIdParameter>
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-Confirm]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IgnoreDehydratedFlag]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantineRetentionDays <Int32>]
[-WhatIf]
[<CommonParameters>] Descrizione
Non è possibile modificare i criteri di quarantena predefiniti denominati AdminOnlyAccessPolicy o DefaultFullAccessPolicy.
È 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
Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1In questo esempio vengono configurate le autorizzazioni nei criteri di quarantena denominati CustomAccess che consentono agli utenti di eliminare solo i messaggi in quarantena.
Esempio 2
Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息，请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00Questo esempio modifica le impostazioni globali per le notifiche di quarantena (in precedenza note come impostazioni di notifica della posta indesiderata dell'utente finale):
- Le notifiche di quarantena vengono personalizzate per inglese, cinese e francese. Nel valore francese MultiLanguageCustomDisclaimer sono necessarie virgolette aggiuntive come caratteri di escape per i caratteri di virgolette nel testo.
- L'utente aashutosh@contso.onmicrosoft.com esistente viene usato come mittente della notifica di quarantena.
- Il logo personalizzato configurato in precedenza sostituisce il logo Microsoft predefinito.
- La frequenza delle notifiche di quarantena viene modificata in 4 ore.
Parametri
-AdminNotificationFrequencyInDays
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationLanguage
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | EsnLanguage |
| Accepted values: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminNotificationsEnabled
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-AdminQuarantinePermissionsList
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, 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 utilizzando 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, Exchange Online Protection |
-CustomDisclaimer
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DomainController
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissions
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | QuarantinePermissions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserQuarantinePermissionsValue
Il parametro EndUserQuarantinePermissionsValue specifica le autorizzazioni dell'utente finale per i criteri di quarantena.
Questo parametro usa un valore decimale convertito da un valore binario. Il valore binario corrisponde all'elenco delle autorizzazioni disponibili in un ordine specifico. Per ogni autorizzazione, il valore 1 è uguale a True e il valore 0 è false. L'ordine richiesto è descritto nell'elenco seguente da più alto (1000000 o 128) al più basso (00000001 o 1):
- PermissionToViewHeader: il valore 0 non nasconde l'azione Visualizza intestazione messaggio in quarantena. Se il messaggio è visibile in quarantena, l'azione è sempre disponibile per il messaggio.
- PermissionToDownload: questa autorizzazione non viene usata (il valore 0 o 1 non esegue alcuna operazione).
- PermissionToAllowSender: questa autorizzazione non viene usata (il valore 0 o 1 non esegue alcuna operazione).
- PermissionToBlockSender
- PermissionToRequestRelease: non impostare questa autorizzazione e PermissionToRelease sul valore 1. Impostare un valore su 1 e l'altro su 0 oppure impostare entrambi i valori su 0.
- PermissionToRelease: non impostare questa autorizzazione e PermissionToRequestRelease sul valore 1. Impostare un valore su 1 e l'altro su 0 oppure impostare entrambi i valori su 0. Questa autorizzazione non viene rispettata per i messaggi messi in quarantena come malware o phishing ad alta attendibilità. Se il criterio di quarantena concede agli utenti questa autorizzazione, gli utenti possono richiedere il rilascio del malware in quarantena o dei messaggi di phishing ad alta attendibilità come se fosse stata selezionata invece l'opzione PermissionToRequestRelease.
- PermissionToPreview
- PermissionToDelete
I valori per i gruppi di autorizzazioni dell'utente finale preimpostati sono descritti nell'elenco seguente:
- Nessun accesso: Binary = 00000000, quindi usare il valore decimale 0.
- Accesso limitato: Binary = 00011011, quindi usare il valore decimale 27.
- Accesso completo: Binary = 00010111, quindi usare il valore decimale 23.
Per le autorizzazioni personalizzate, ottenere il valore binario corrispondente alle autorizzazioni desiderate. Convertire il valore binario in un valore decimale da utilizzare. Non usare il valore binario per questo parametro.
Nota: se il valore di questo parametro è 0 (Nessun accesso) e il valore del parametro ESNEnabled è $true, gli utenti possono visualizzare i messaggi in quarantena, ma l'unica azione disponibile per i messaggi è Visualizza intestazione messaggio.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationCustomFromAddress
EndUserSpamNotificationCustomFromAddress specifica l'indirizzo di posta elettronica di un mittente interno esistente da usare come mittente per le notifiche di quarantena. Per impostare nuovamente questo parametro sull'indirizzo quarantine@messaging.microsoft.comdi posta elettronica predefinito, usare il valore $null.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequency
Il parametro EndUserSpamNotificationFrequency specifica la frequenza con cui vengono inviate notifiche di quarantena agli utenti. I valori validi sono:
- 04:00:00 (4 ore)
- 1.00:00:00 (1 giorno)
- 7.00:00:00 (7 giorni)
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationFrequencyInDays
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EndUserSpamNotificationLanguage
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | EsnLanguage |
| Accepted values: | Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EsnCustomSubject
Il parametro EsnCustomSubject specifica il testo da utilizzare nel campo Oggetto delle notifiche di quarantena.
È possibile specificare più valori separati da virgole usando la sintassi : ('value1',''value2',...'valueN'). Per ogni lingua specificata con il parametro MultiLanguageSetting, è necessario specificare testo mittente univoco. Assicurarsi di allineare i valori dei parametri MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject e MultiLanguageSenderName corrispondenti nello stesso ordine.
Per modificare un valore esistente e mantenere altri valori, è necessario specificare tutti i valori esistenti e il nuovo valore nell'ordine esistente.
Questa impostazione è disponibile solo nei criteri di quarantena predefiniti denominati DefaultGlobalTag che controllano le impostazioni dei criteri di quarantena globali. Per accedere a questo criterio di quarantena, avviare il comando con la sintassi seguente: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | undefined |
| Aliases: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ESNEnabled
Il parametro ESNEnabled consente di specificare se abilitare le notifiche di quarantena (in precedenza note come notifiche di posta indesiderata dell'utente finale) per i criteri. I valori validi sono:
- $true: le notifiche di quarantena sono abilitate.
- $false: le notifiche di quarantena sono disabilitate. L'utente può accedere ai messaggi in quarantena solo in quarantena, non nelle notifiche tramite posta elettronica. Questo è il valore predefinito.
Nota: se il valore di questo parametro è $true e il valore del parametro EndUserQuarantinePermissionsValue è 0 (Nessun accesso in cui tutte le autorizzazioni sono disattivate), gli utenti possono visualizzare i messaggi in quarantena, ma l'unica azione disponibile per i messaggi è Visualizza intestazione del messaggio.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Il parametro Identity consente di specificare i criteri di quarantena che si desidera modificare. È possibile usare qualsiasi valore che identifichi in modo univoco i criteri di quarantena. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | QuarantineTagIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IgnoreDehydratedFlag
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageCustomDisclaimer
Il parametro MultiLanguageCustomDisclaimer specifica il testo della dichiarazione di non responsabilità personalizzato da usare nella parte inferiore delle notifiche di quarantena. Il testo localizzato, Una dichiarazione di non responsabilità dell'organizzazione: viene sempre incluso per primo, seguito dal testo specificato per questo parametro.
È possibile specificare più valori separati da virgole usando la sintassi : ('value1',''value2',...'valueN'). Per ogni lingua specificata con il parametro MultiLanguageSetting, è necessario specificare testo di dichiarazione di non responsabilità personalizzato univoco. Assicurarsi di allineare i valori dei parametri MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject e MultiLanguageSenderName corrispondenti nello stesso ordine.
Per modificare un valore esistente e mantenere altri valori, è necessario specificare tutti i valori esistenti e il nuovo valore nell'ordine esistente.
Questa impostazione è disponibile solo nei criteri di quarantena predefiniti denominati DefaultGlobalTag che controllano le impostazioni dei criteri di quarantena globali. Per accedere a questo criterio di quarantena, avviare il comando con la sintassi seguente: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSenderName
Il parametro MultiLanguageSenderName specifica il nome visualizzato del mittente del messaggio di posta elettronica da usare nelle notifiche di quarantena.
È possibile specificare più valori separati da virgole usando la sintassi : ('value1',''value2',...'valueN'). Per ogni lingua specificata con il parametro MultiLanguageSetting, è possibile specificare un nome di mittente univoco. Assicurarsi di allineare i valori dei parametri MultiLanguageSetting, MultiLanguageCustomDisclaimer e MultiLanguageSenderName corrispondenti nello stesso ordine.
Per modificare un valore esistente e mantenere altri valori, è necessario specificare tutti i valori esistenti e il nuovo valore nell'ordine esistente.
Questa impostazione è disponibile solo nei criteri di quarantena predefiniti denominati DefaultGlobalTag che controllano le impostazioni globali. Per accedere a questo criterio di quarantena, avviare il comando con la sintassi seguente: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MultiLanguageSetting
Il parametro MultiLanguageSetting specifica la lingua delle notifiche di quarantena. I valori validi sono:
Default, Amharic, Arabic, Basque, BengaliIndia, Bulgarian, Catalan, ChineseSimplified, ChineseTraditional, Croato, cirillico, ceco, danese, olandese, inglese, estone, filipino, finlandese, francese, galiziano, tedesco, greco, gujarati, ebraico, hindi, ungherese, islandese, indonesiano, italiano, giapponese, kannada, kazako, coreano, lettone, lituano, malese, marathi, norvegese, norvegeseNynorsk, odia, persiano, polacco, portoghese, portoghesePortugal, rumeno, russo, serbo, cirillico, Slovacco, sloveno, spagnolo, swahili, svedese, tamil, telugu, tailandese, turco, ucraino, urdu e vietnamita.
È possibile specificare più valori separati da virgole usando la sintassi : ('value1',''value2',...'valueN'). Il valore predefinito è Default, ovvero le notifiche di quarantena usano la lingua predefinita dell'organizzazione basata sul cloud.
Per ogni lingua specificata, è possibile specificare un valore univoco per i parametri MultiLanguageCustomDisclaimer e MultiLanguageSenderName. Assicurarsi di allineare i valori dei parametri MultiLanguageSetting, MultiLanguageCustomDisclaimer e MultiLanguageSenderName corrispondenti nello stesso ordine.
Questa impostazione è disponibile solo nei criteri di quarantena predefiniti denominati DefaultGlobalTag che controllano le impostazioni globali. Per accedere a questo criterio di quarantena, avviare il comando con la sintassi seguente: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationBrandingEnabled
Il parametro OrganizationBrandingEnabled abilita o disabilita la personalizzazione dell'organizzazione nei messaggi di notifica di quarantena degli utenti finali. I valori validi sono:
- $true: la personalizzazione dell'organizzazione è abilitata. Il logo Microsoft predefinito usato nelle notifiche di quarantena viene sostituito dal logo personalizzato. Prima di eseguire questa operazione, è necessario seguire le istruzioni in Personalizzare il tema di Microsoft 365 per consentire all'organizzazione di caricare il logo personalizzato.
- $false: la personalizzazione dell'organizzazione è disabilitata. Il logo Microsoft predefinito viene usato nelle notifiche di quarantena. Questo è il valore predefinito.
Questa impostazione è disponibile solo nei criteri di quarantena predefiniti denominati DefaultGlobalTag che controllano le impostazioni globali. Per accedere a questo criterio di quarantena, avviare il comando con la sintassi seguente: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-QuarantineRetentionDays
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, 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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |