Condividi tramite


New-QuarantinePolicy

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-QuarantinePolicy per creare criteri di quarantena nell'organizzazione basata sul cloud.

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

Sintassi

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>]
   [-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 di quarantena. Per ulteriori informazioni, vedere criteri di quarantena.

È 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

New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0

In questo esempio viene creato un nuovo criterio di quarantena denominato ContosoTag con le stesse autorizzazioni del gruppo No access preset permissions .this example creates a new quarantine policy named ContosoTag with the same permissions as the No access preset permissions group.

Per assegnare autorizzazioni di accesso limitate, usare il valore 27. Per assegnare autorizzazioni di accesso completo, usare il valore 23.

Parametri

-AdminDisplayName

Il parametro AdminDisplayName specifica una descrizione per i criteri di quarantena. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

-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

-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 è $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: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.

Se non si usa questo parametro, il mittente predefinito è quarantine@messaging.microsoft.com.

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 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

-MultiLanguageCustomDisclaimer

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

-MultiLanguageSenderName

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

-MultiLanguageSetting

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

-Name

Il parametro Name consente di specificare un nome univoco per i criteri di quarantena. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

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

-QuarantinePolicyType

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:QuarantinePolicyType
Accepted values:QuarantinePolicy, GlobalQuarantinePolicy
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