Add-AttachmentFilterEntry

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile o efficace solo nei server Trasporto Edge in Exchange locale.

Utilizzare il cmdlet Add-AttachmentFilterEntry per aggiungere una voce nell'elenco dei filtri degli allegati utilizzato dall'agente filtro allegati nei server Trasporto Edge.

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

Sintassi

Add-AttachmentFilterEntry
   -Name <String>
   -Type <AttachmentType>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Nei server Trasporto Edge, l'agente filtro allegati blocca gli allegati dei messaggi in base al tipo di contenuto e al nome del file dell'allegato. La configurazione dell'agente filtro allegati determina la modalità di elaborazione dei messaggi che contengono gli allegati specificati. Per ulteriori informazioni su come configurare l'agente di filtro degli allegati, vedere Set-AttachmentFilterListConfig.

Sui server Trasporto Edge, è necessario essere membri del gruppo di amministratori locale per eseguire questo cmdlet.

Esempio

Esempio 1

Add-AttachmentFilterEntry -Name *.txt -Type FileName

Nel primo esempio viene aggiunta una voce di filtro degli allegati in base al nome file. Dopo aver eseguito questo comando, l'agente Filtro allegati filtra tutti gli allegati con estensione TXT.

Esempio 2

Add-AttachmentFilterEntry -Name image/jpeg -Type ContentType

Nel secondo esempio viene aggiunta una voce di filtro degli allegati basata sul tipo di contenuto MIME image/jpeg, che corrisponde a un file binario di immagine con estensione JPEG. Dopo aver eseguito questo comando, l'agente Filtro allegati filtra tutti gli allegati del tipo di contenuto MIME image/jpeg.

Parametri

-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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

Il parametro Name consente di specificare i file che si desidera bloccare. I valori validi sono:

  • Un nome di file esatto (ad esempio, BadFile.exe) o un'estensione del nome di file (ad esempio, *.exe). È necessario usare il valore Filename per il parametro Type.
  • Tipo di contenuto MIME valido, ad esempio application/javascript o text/scriplet. È necessario usare il valore ContentType per il parametro Type.
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Type

Il parametro Type consente di specificare il tipo di allegato che la voce del filtro degli allegati deve bloccare. I valori validi sono:

  • ContentType: questo valore corrisponde alla voce di filtro degli allegati rispetto al tipo di contenuto MIME specificato nel parametro Name.
  • FileName: questo valore corrisponde alla voce del filtro degli allegati rispetto al nome di file semplice specificato nel parametro Name.
Type:AttachmentType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, 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.