New-QuarantinePolicy
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet New-QuarantinePolicy per creare criteri di quarantena nell'organizzazione basata su cloud.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
New-QuarantinePolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AdminNotificationFrequencyInDays <Int32>]
[-AdminNotificationLanguage <EsnLanguage>]
[-AdminNotificationsEnabled <Boolean>]
[-AdminQuarantinePermissionsList <MultiValuedProperty>]
[-CustomDisclaimer <String>]
[-DomainController <Fqdn>]
[-EndUserQuarantinePermissions <QuarantinePermissions>]
[-EndUserQuarantinePermissionsValue <Int32>]
[-EndUserSpamNotificationCustomFromAddress <String>]
[-EndUserSpamNotificationFrequency <TimeSpan>]
[-EndUserSpamNotificationFrequencyInDays <Int32>]
[-EndUserSpamNotificationLanguage <EsnLanguage>]
[-EsnCustomSubject <MultiValuedProperty>]
[-ESNEnabled <Boolean>]
[-IncludeMessagesFromBlockedSenderAddress <Boolean>]
[-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
[-MultiLanguageSenderName <MultiValuedProperty>]
[-MultiLanguageSetting <MultiValuedProperty>]
[-OrganizationBrandingEnabled <Boolean>]
[-QuarantinePolicyType <QuarantinePolicyType>]
[-QuarantineRetentionDays <Int32>]
[<CommonParameters>]
Descrizione
I criteri di quarantena definiscono le operazioni consentite agli utenti per i messaggi in quarantena in base al motivo per cui il messaggio è stato messo in quarantena (per le funzionalità supportate) e alle impostazioni di notifica della quarantena. Per ulteriori informazioni, vedere criteri di quarantena.
È 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
New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0
In questo esempio viene creato un nuovo criterio di quarantena denominato ContosoTag con le stesse autorizzazioni del gruppo di autorizzazioni predefinite di Nessun accesso.
Per assegnare autorizzazioni di accesso limitato, utilizzare il valore 27. Per assegnare le autorizzazioni di accesso completo, utilizzare il valore 23.
Parametri
-AdminDisplayName
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro AdminDisplayName consente di specificare una descrizione per il criterio di quarantena. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| 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 |
-AdminNotificationFrequencyInDays
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Int32 |
| 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 |
-AdminNotificationLanguage
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | EsnLanguage |
| Valore predefinito: | None |
| Valori accettati: | 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 |
| 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 |
-AdminNotificationsEnabled
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-AdminQuarantinePermissionsList
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-CustomDisclaimer
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | String |
| 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 |
-DomainController
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Fqdn |
| 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 |
-EndUserQuarantinePermissions
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Nota: per impostare le autorizzazioni nei criteri di quarantena, è consigliabile usare il parametro EndUserQuarantinePermissionsValue .
EndUserQuarantinePermissions specifica le autorizzazioni dell'utente finale per i criteri di quarantena utilizzando una variabile nell'output di un comando New-QuarantinePermissions o Set-QuarantinePermissions.
Ad esempio, eseguire il comando seguente per memorizzare le autorizzazioni necessarie in una variabile: $Perms = New-QuarantinePermissions <permissions>. Nella stessa sessione di PowerShell, usare il valore $Perms per questo parametro.
Proprietà dei parametri
| Tipo: | QuarantinePermissions |
| 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 |
-EndUserQuarantinePermissionsValue
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro EndUserQuarantinePermissionsValue consente di specificare le autorizzazioni dell'utente finale per il criterio 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 è uguale a False. L'ordine richiesto è descritto nell'elenco seguente, dal 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 utilizzata (il valore 0 o 1 non esegue alcuna operazione).
- PermissionToAllowSender
- PermissionToBlockSender
- PermissionToRequestRelease: non impostare questa autorizzazione e PermissionToRelease sul valore 1. Impostare un valore su 1 e l'altro valore 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 valore su 0 oppure impostare entrambi i valori su 0. Questa autorizzazione non viene rispettata per i messaggi che sono stati messi in quarantena come malware o phishing con alta attendibilità. Se i criteri di quarantena concedono agli utenti questa autorizzazione, gli utenti possono richiedere il rilascio del malware in quarantena o dei messaggi di phishing con alta attendibilità come se fosse stato selezionato PermissionToRequestRelease.
- PermissionToPreview
- PermissionToDelete
I valori per i gruppi di autorizzazione degli utenti finali preimpostati sono descritti nell'elenco seguente:
- Nessun accesso: binario = 0000000, quindi usare il valore decimale 0.
- Accesso limitato: binario = 00101011, quindi usare il valore decimale 43.
- Accesso completo: binario = 00100111, quindi usare il valore decimale 39.
Per le autorizzazioni personalizzate, ottenere il valore binario corrispondente alle autorizzazioni desiderate. Convertire il valore binario in un valore decimale da usare. 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.
Proprietà dei parametri
| Tipo: | Int32 |
| 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 |
-EndUserSpamNotificationCustomFromAddress
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
EndUserSpamNotificationCustomFromAddress specifica l'indirizzo e-mail di un mittente interno esistente da usare come mittente per le notifiche di quarantena.
Se non si utilizza questo parametro, il mittente predefinito è quarantine@messaging.microsoft.com.
Proprietà dei parametri
| Tipo: | String |
| 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 |
-EndUserSpamNotificationFrequency
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro EndUserSpamNotificationFrequency consente di specificare la frequenza con cui le notifiche di quarantena vengono inviate agli utenti. I valori validi sono:
- 04:00:00 (4 ore)
- 1.00:00:00 (1 giorno)
- 7.00:00:00 (7 giorni)
Proprietà dei parametri
| Tipo: | TimeSpan |
| 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 |
-EndUserSpamNotificationFrequencyInDays
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Int32 |
| 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 |
-EndUserSpamNotificationLanguage
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | EsnLanguage |
| Valore predefinito: | None |
| Valori accettati: | 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 |
| 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 |
-EsnCustomSubject
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro EsnCustomSubject consente di specificare il testo da usare 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 il testo univoco del mittente. Assicurarsi di allineare i valori dei parametri MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject e MultiLanguageSenderName corrispondenti nello stesso ordine.
Per modificare un valore esistente e mantenere gli altri valori, è necessario specificare tutti i valori esistenti e il nuovo valore nell'ordine esistente.
Questa impostazione è disponibile solo nel criterio di quarantena predefinito denominato DefaultGlobalTag che controlla le impostazioni globali del criterio di quarantena. Per accedere a questo criterio di quarantena, avviare il comando con la seguente sintassi: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | MultiValuedProperty |
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 |
-ESNEnabled
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro ESNEnabled consente di specificare se abilitare le notifiche di quarantena (in precedenza note come notifiche di spam per gli utenti finali) per il criterio. I valori validi sono:
- $true: le notifiche di quarantena sono abilitate.
- $false: le notifiche di quarantena sono disabilitate. L'utente può accedere solo ai messaggi in quarantena in quarantena, non nelle notifiche e-mail. 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 messaggio.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-IncludeMessagesFromBlockedSenderAddress
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro IncludeMessagesFromBlockedSenderAddress consente di specificare se inviare notifiche di quarantena per i messaggi in quarantena da indirizzi mittenti bloccati. I valori validi sono:
- $true: i destinatari ricevono notifiche di quarantena per i messaggi interessati da mittenti bloccati.
- $false: I destinatari non ricevono notifiche di quarantena per i messaggi interessati da mittenti bloccati. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | False |
| 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 |
-MultiLanguageCustomDisclaimer
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-MultiLanguageSenderName
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-MultiLanguageSetting
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-Name
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Il parametro Name consente di specificare un nome univoco per il criterio di quarantena. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OrganizationBrandingEnabled
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-QuarantinePolicyType
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | QuarantinePolicyType |
| Valore predefinito: | None |
| Valori accettati: | QuarantinePolicy, GlobalQuarantinePolicy |
| 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 |
-QuarantineRetentionDays
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Int32 |
| 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 |
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.