Antivirus: Stsadm properties (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2007-09-06

Windows SharePoint Services 3.0 now allows you to help protect your users from uploading or downloading files that contain viruses. When you have installed an antivirus scanner that is compatible with Windows SharePoint Services 3.0, you can enable the antivirus protection feature for your server. When you enable the antivirus protection feature, files are checked for viruses when a user adds a document to a document library or list, or when a user views a document in a document library or list. If a virus is found, the scanner attempts to clean the file. If the file cannot be cleaned, the scanner blocks the file from being added or viewed.

Note

If a file is uploaded and is later identified as containing a virus, users will not be able to open the file. In this situation, the administrator can still allow users the ability to save the file locally and open it from their computer. For more information, see Avallowdownload.

You must install Windows SharePoint Services-compatible antivirus software on any server computer running Windows SharePoint Services before you can enable antivirus protection in Windows SharePoint Services 3.0. If you are in a server farm configuration, antivirus software must be installed on every front-end Web server in the server farm. Consult your antivirus software vendor to find out whether they offer a virus scanner for use with Windows SharePoint Services 3.0 and for information about installing the virus scanner.

The antivirus properties are part of the setproperty and getproperty operations. The syntax for the setproperty operation is:

stsadm -o setproperty

-propertyname <property name>

-propertyvalue <property value>

**\[-url\] \<URL\>**

The syntax for the getproperty operation is:

stsadm -o getproperty

-propertyname <property name>

**\[-url\]** \<URL\>

Note

You can substitute -pn for -propertyname and -pv for -propertyvalue.

The following table describes the antivirus properties.

Property name Description

Avallowdownload: Stsadm property (Windows SharePoint Services)

Specifies whether users can download infected documents to their local computers.

Avcleaningenabled: Stsadm property (Windows SharePoint Services)

Specifies whether antivirus cleaning is enabled or disabled.

Avdownloadscanenabled: Stsadm property (Windows SharePoint Services)

Specifies whether documents are scanned when they are downloaded.

Avnumberofthreads: Stsadm property (Windows SharePoint Services)

Specifies the number of threads to use for antivirus processes.

Avtimeout: Stsadm property (Windows SharePoint Services)

Specifies how long to wait before an antivirus process times out.

Avuploadscanenabled: Stsadm property (Windows SharePoint Services)

Specifies whether documents are scanned when they are uploaded.