Set-MalwareFilteringServer
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Set-MalwareFilteringServer per configurare le impostazioni dell'agente Malware nel servizio di trasporto su un server Cassette postali.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-MalwareFilteringServer
[-Identity] <MalwareFilteringServerIdParameter>
[-BypassFiltering <Boolean>]
[-Confirm]
[-DeferAttempts <Int32>]
[-DeferWaitTime <Int32>]
[-DomainController <Fqdn>]
[-ForceRescan <Boolean>]
[-MinimumSuccessfulEngineScans <Int32>]
[-PrimaryUpdatePath <String>]
[-ScanErrorAction <MalwareScanErrorAction>]
[-ScanTimeout <Int32>]
[-SecondaryUpdatePath <String>]
[-UpdateFrequency <Int32>]
[-UpdateTimeout <Int32>]
[-WhatIf]
[<CommonParameters>] Descrizione
È 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-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10In questo esempio vengono impostate le seguenti impostazioni dell'agente Malware sul server Cassette postali Mailbox01:
- Consente di impostare la frequenza di aggiornamento a 2 ore
- Consente di impostare il tempo di attesa tra i tentativi di rinvio a 10 minuti
Parametri
-BypassFiltering
Il parametro BypassFiltering consente di ignorare temporaneamente il filtro di protezione dal malware disabilitando l'agente Malware sul server. L'agente Malware è ancora attivo e viene tuttora richiamato per ogni messaggio, ma in effetti non viene eseguito alcun filtro di protezione dal malware. In questo modo è possibile disabilitare temporaneamente e poi abilitare il filtro di protezione dal malware sul server senza interrompere il flusso di posta come avverrebbe con un riavvio del servizio Trasporto di Microsoft Exchange. L'input valido per questo parametro è $true o $false. Il valore predefinito è $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferAttempts
Il parametro DeferAttempts consente di specificare il numero massimo di posticipazioni di un messaggio che non può essere analizzato dall'agente Malware. I valori validi per questo parametro sono i numeri interi compresi tra 1 e 5. Il valore predefinito è 3.
Una volta raggiunto il numero massimo di posticipazioni, l'azione dell'agente Malware dipende dall'errore. Per analizzare i timeout e gli errori del modulo, è necessario rifiutare il messaggio e inviare un rapporto di mancato recapito (NDR) al mittente subito dopo l'ultimo tentativo di rinvio. Per tutti gli altri errori, il messaggio viene rielaborato fino ad un massimo di 48 ore e ogni tentativo impiega un'ora in più dell'ultimo per essere elaborato. Ad esempio, dopo l'ultimo tentativo di rinvio, il primo tentativo si verifica dopo un'ora, il tentativo successivo dopo due ore, il prossimo ancora dopo tre ore e così via fino ad un massimo di 48 ore. Al termine delle 48 ore, è necessario rifiutare il messaggio e inviare un rapporto di mancato recapito (NDR) al mittente.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DeferWaitTime
Il parametro DeferWaitTime consente di specificare il tempo, in minuti, di cui aumentare l'intervallo di rinvio dei messaggi per il filtro di protezione dal malware, nel tentativo di ridurre il carico di lavoro sul server.
Ad esempio, il primo tentativo dopo l'analisi originale non riuscita avviene dopo l'intervallo specificato dal parametro DeferWaitTime. Il secondo tentativo avviene dopo il doppio dell'intervallo specificato dal parametro DeferWaitTime. Il terzo tentativo dopo il secondo tentativo si verifica dopo tre volte il valore del parametro DeferWaitTime e così via. Il numero massimo di tentativi è controllato dal parametro DeferAttempts.
I valori validi per questo parametro sono i numeri interi compresi tra 0 e 15. Il valore predefinito è 5. Ciò significa che il primo nuovo invio si verifica 5 minuti dopo l'analisi originale non riuscita, il secondo tentativo si verifica 10 minuti dopo il primo tentativo, il terzo viene eseguito 15 minuti dopo il secondo e così via. Il valore 0 indica che i messaggi vengono rinviati al filtro di protezione dal malware dopo qualunque tentativo di analisi non riuscito, senza alcun ritardo.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ForceRescan
Il parametro ForceRescan specifica che i messaggi devono essere analizzati dall'agente malware, anche se il messaggio è già stato analizzato da Exchange Online Protection. L'input valido per questo parametro è $true o $false. Il valore predefinito è $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare il server di cui si desidera configurare le impostazioni di protezione dal malware. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- DN legacy di Exchange
| Type: | MalwareFilteringServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MinimumSuccessfulEngineScans
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 Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PrimaryUpdatePath
Il parametro PrimaryUpdatePath consente di specificare la posizione in cui scaricare gli aggiornamenti del motore di scansione del malware. Il valore predefinito è http://forefrontdl.microsoft.com/server/scanengineupdate. Il percorso specificato dal parametro PrimaryUpdatePath viene sempre provato per primo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanErrorAction
Il parametro ScanErrorAction consente di specificare l'azione da compiere quando un messaggio non può essere analizzato dal filtro di protezione dal malware. I valori validi per questo parametro sono Block o Allow. Il valore predefinito è Block.
| Type: | MalwareScanErrorAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ScanTimeout
Il parametro ScanTimeout consente di specificare l'intervallo di timeout, in secondi, per i messaggi che non possono essere analizzati dal filtro di protezione dal malware. I valori validi per questo parametro sono i numeri interi compresi tra 10 e 900. Il valore predefinito è 300 (5 minuti).
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SecondaryUpdatePath
Il parametro SecondaryUpdatePath consente di specificare una posizione di download alternativa per gli aggiornamenti del motore di scansione del malware. Il valore predefinito è vuoto ($null). Con questo valore non viene specificata alcuna posizione di download alternativa.
La posizione di download alternativa viene utilizzata quando il percorso specificato dal parametro PrimaryUpdatePath non è disponibile nel periodo specificato dal parametro UpdateTimeout. Al successivo aggiornamento del motore di scansione del malware, viene provato per prima cosa il percorso specificato dal parametro PrimaryUpdatePath.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateFrequency
Il parametro UpdateFrequency consente di specificare la frequenza, in minuti, di verifica della disponibilità di aggiornamenti del motore di scansione del malware. I valori validi per questo parametro sono i numeri interi compresi tra 1 e 38880 (27 giorni). Il valore predefinito è pari a 60 (un'ora). I percorsi per la verifica degli aggiornamenti sono specificati dai parametri PrimaryUpdatePath e SecondaryUpdatePath.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UpdateTimeout
Il parametro UpdateTimeout consente di specificare l'intervallo di timeout, in secondi, da utilizzare per la verifica della disponibilità di aggiornamenti del motore di scansione del malware. I valori validi per questo parametro sono i numeri interi compresi tra 60 e 300. Il valore predefinito è 150 secondi (2,5 minuti).
Se il percorso specificato dal parametro PrimaryUpdatePath non è disponibile nel periodo specificato dal valore del parametro UpdateTimeout, viene utilizzata la posizione specificata dal parametro SecondaryUpdatePath.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per