• Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

 

MSFT_SIPIIMFilterFileFilterSetting

MSFT_SIPIIMFilterFileFilterSetting

Specifies the action to perform for a file transfer request during an IM session.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class MSFT_SIPIIMFilterFileFilterSetting
{
  string Action;
  [key] string Backend;
  boolean Enabled;
  [key] string InstanceID;
  string[] Schemes;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPIIMFilterFileFilterSetting class has the following properties.

  • Action
    Data type: string

    Access type: Read/Write

    Required. Specifies the action to perform on IM messages that contain a file transfer request.

    The value of this property is not case-sensitive.

    Value

    Description

    "BlockAll"

    All instant messages that contain file transfer requests are dropped by the server, and an error message is returned to the sender of the request. Additionally, the handout feature in the Office Live Meeting 2007 client is disabled.

    "BlockList"

    Office Communications Server filters only those file transfer requests which contain a file extension that is specified by Schemes property.

    The default value is BlockList.

  • Backend
    Data type: [key] string

    Access type: Read-only

    Must be empty when accessing data from Edge Server or Proxy Server roles. Required when accessing data from any role that belongs to a pool.

    The computer name (either the FQDN or NetBIOS name) and SQL Server instance name of the Office Communications Server 2007, back-end database (configuration data is stored in the same SQL instance as user data, but in a different database). Indicates where this class is stored, which varies depending on the server role.

    Server Role

    Acceptable Values

    Enterprise Edition

    SQL_Instance_Name

    Standard Edition

    (local)\rtc

    Access Edge Server and Forwarding Proxy

    Empty string

  • Enabled
    Data type: boolean

    Access type: Read/Write

    Required. Indicates whether IM filtering is performed for file transfers during IM conversations.

    If true, filtering is performed according to the parameters set by the additional properties of this class. If false, Office Communications Server passes all file transfer requests that are made during IM conversations.

    The default value is true.

  • InstanceID
    Data type: [key] string

    Access type: Read-only A GUID value that uniquely identifies an instance of this class.

    The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".

  • Schemes
    Data type: string[]

    Access type: Read/Write

    Optional. Specifies the list of file extensions that will be blocked if file filtering is enabled.

    A single dot "." blocks transfer for any file that does not have an extension. The default list includes following file extensions: ".ade", ".adp", ".app", ".asp", ".bas", ".bat", ".cer", ".chm", ".cmd", ".com", ".cpl", ".crt", ".csh", ".exe", ".fxp", ".grp", ".hlp", ".hta", ".inf", ".ins", ".isp", ".its", ".js", ".jse", ".ksh", ".lnk", ".mad", ".maf", ".mag", ".mam", ".maq", ".mar", ".mas", ".mat", ".mau", ".mav", ".maw", ".mda", ".mdb", ".mde", ".mdt", ".mdw", ".mdz", ".msc", ".msi", ".msp", ".mst", ".ocx", ".ops", ".pcd", ".pif", ".pl", ".pnp", ".prf", ".prg", ".ps1", ".ps2", ".ps1xml", ".ps2xml", ".psc1", ".psc2", ".pst", ".reg", ".scf", ".scr", ".sct", ".shb", ".shs", ".tmp", ".url", ".vb", ".vbe", ".vbs", ".vsd", ".vsmacros", ".vss", ".vst", ".vsw", ".ws", ".wsc", ".wsf", ".wsh".

    The value of this property is not case-sensitive.

Remarks

This class gets and sets information at the following level(s): WMI, SQL.

If this class is installed on a server whose role has "Pool" scope, the scope of this class is "Pool" and settings are stored in SQL. In this case, only one instance of this class can be present in the pool. For a list of server roles and their corresponding WMI class scopes, see WMI Class Management Scopes and Roles.

Instances of this class support the following interface methods:

Provider::EnumerateInstances(); Provider::GetObject(); Provider::PutInstance();

Where PutInstance() supports the following flag(s):

WBEM_FLAG_CREATE_ONLY WBEM_FLAG_UPDATE_ONLY WBEM_FLAG_CREATE_OR_UPDATE

Requirements

Server: Installed on computers serving the following role(s): Administrative Tools Server, Access Edge Server, Front End Server, Web Conferencing Server.Namespace: Defined in \root\cimv2.

Reference

[<LinkCreatedDuringXmlConversion>]

Concepts

Office Communications Server WMI Reference