Command-Line Properties (Windows SharePoint Services 2.0)
This topic lists and explains the properties that can be set on the command line by using the Stsadm.exe tool with the getproperty and setproperty operations. To see the current value of a property, you use the getproperty operation. To set the value for a property, you use the setproperty operation. The following examples show the syntax to use when getting or setting a property:
stsadm.exe -o getproperty -pn <property name> [-url <url>]
stsadm.exe -o setproperty -pn <property name> -pv <property value> [-url <url>]
Some properties are available for the entire server, and are called server properties. Some are only available for an individual virtual server. When you get or set a server property, you can omit the url parameter. You must include the url parameter to get or set virtual server properties. For more information about setting properties, see Introducing the Administration Tools for Windows SharePoint Services 2.0 in the Windows SharePoint Services Administrator's Guide.
Server Properties for Windows SharePoint Services
Antivirus properties
Content database properties
Data retrieval services properties
General server properties
HTML Viewer properties
Security properties
Site confirmation and automatic deletion properties
Usage analysis properties
Virtual Server Properties for Windows SharePoint Services
Alert properties
Data retrieval services properties
General virtual server properties
Security properties
Site confirmation and automatic deletion properties
Web Part configuration properties
Alert Properties
Use these properties to configure alerts for your server. The alerts-enabled, alerts-limited, and alerts-maximum properties can be set at either the server (and server farm) or virtual server level. Use the -url parameter to configure these properties for a specific virtual server or omit it to configure these properties for an entire server. The job-daily-alerts, job-immediate-alerts, and job-weekly-alerts properties can be set only at the virtual server level. You must specify the -url parameter when you configure these properties. For more information about alerts, see Managing Alerts (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
alerts-enabled |
Specifies whether alerts are enabled for this virtual server |
"true" or "false" |
alerts-limited |
Specifies whether users are limited as to the number of alerts they can create |
"true" or "false" |
alerts-maximum |
If alerts-limited is configured, specifies the maximum number of alerts that users can create |
A numerical value |
job-daily-alerts |
Specifies the time to send out daily alerts |
A phrase that includes the frequency interval and time range to send out notifications. For example "daily between 22:00:00 and 06:00:00". |
job-immediate-alerts |
Specifies how long to wait before sending out daily alerts |
A phrase that includes the frequency interval and time range to send out notifications. For example "every 5 minutes between 0 and 59". |
job-weekly-alerts |
Specifies the day and time to send out weekly alerts |
A phrase that includes the frequency interval and time range to send out notifications. For example "weekly between Fri 22:00:00 and Mon 06:00:00". |
Antivirus Properties
Use these properties to configure antivirus protection for your server. These properties can be set only at the server (and server farm) level. You do not need to specify the -url parameter when you configure these properties. For more information about using antivirus scanning, see Configuring Antivirus Protection (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
avallowdownload |
Specifies whether users can download infected files to their client computers |
"yes" or "no" |
avcleaningenabled |
Specifies whether antivirus cleaning is enabled |
"yes" or "no" |
avdownloadscanenabled |
Specifies whether the download scans are enabled |
"yes" or "no" |
avnumberofthreads |
Specifies the number of threads to take up with antivirus processes |
A numerical value, the number of threads to use |
avtimeout |
Specifies the timeout time for scanning |
A numerical value, in seconds |
avuploadscanenabled |
Specifies whether the upload scans are enabled |
"yes" or "no" |
Content Database Properties
Use these properties to set the server name, user name, and password to use for the default content database for your server. These properties can be set only at the server (and server farm) level. You do not need to specify the -url parameter when you configure these properties.
Property name | Description | Values |
---|---|---|
defaultcontentdb-password |
Specifies the password for the defaultcontentdb-user |
A password |
defaultcontentdb-server |
Specifies the server that contains the default content database |
A server name |
defaultcontentdb-user |
Specifies the username for the default content database |
A user account in the format DOMAIN\username |
Data Retrieval Services Properties
Use these properties to configure data retrieval services for your virtual server, server, or server farm. These properties can be set at either the server or virtual server level. Use the -url parameter to configure these properties for a specific virtual server or omit it to configure these properties for an entire server. For more information about data retrieval services, see Configuring Data Retrieval Services (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
data-retrieval-services-enabled |
Specifies whether data retrieval services are enabled |
"true" or "false" |
data-retrieval-services-enabled-list |
The list of services to which the data-retrieval-services-enabled setting applies |
A list of services, such as "OLEDB;SOAP Passthrough" |
data-retrieval-services-inherit |
Specifies whether to inherit the server farm settings for a virtual server |
"true" or "false" |
data-retrieval-services-response-size |
Specifies the maximum size for data returned from the back-end source |
An integer value in kilobytes (KB) between 1 and 100,000 |
data-retrieval-services-response-size-list |
The list of services to which the data-retrieval-services-response-size setting applies |
A list of services, such as "OLEDB" |
data-retrieval-services-timeout |
Specifies the time an adapter will wait for a response from the back-end data source |
An integer value in seconds between 1 and 100,000 |
data-retrieval-services-timeout-list |
The list of services to which the data-retrieval-services-timeout setting applies |
A list of services, such as "OLEDB" |
data-retrieval-services-update |
Specifies whether adapters can execute requests that contain updatable queries |
"true" or "false" |
data-retrieval-services-update-list |
The list of services to which the data-retrieval-services-update setting applies |
A list of services, such as "OLEDB" |
data-retrieval-services-oledb-providers |
Specifies the list of supported OLEDB providers |
The list of OLEDB providers, separated by semi-colons For example: "DB2OLEDB;IBMDADB2;MSDAORA;OraOLEDB.Oracle;SQLOLEDB" |
General Virtual Server Properties
Use the following properties to specify general settings for a virtual server. These properties can be set only at the virtual server level. You must specify the -url parameter when you configure these properties. For more information about specifying virtual server general settings, see Configuring Virtual Servers (Windows SharePoint Services 2.0). For more information about large-file-chuck-size, see "Configuring large file support" in Installing and Using Service Packs for Windows SharePoint Services 2.0.
Property name | Description | Values |
---|---|---|
days-to-show-new-icon |
Specifies how long (in days) to display the New icon for items added to a Web site |
A numerical value (number of days) |
defaultquotatemplate |
Specifies the default quota template for Web sites |
A quota template name |
defaulttimezone |
Specifies the default time zone for Web sites |
A time zone (numerical). For a list of valid time zones, see Regional and language settings (Windows SharePoint Services 2.0). |
large-file-chunk-size |
Specifies the chunk size to use for large files |
A numerical value, in megabytes (MB). The default value is 5 MB. |
max-file-post-size |
Specifies the maximum size for files posted to Web sites |
A numerical value, in megabytes (MB). The default value is 50 MB. |
General Server Properties
Use these properties to specify settings for your server. These properties can be set only at the server (and server farm) level. You do not need to specify the -url parameter when you configure these properties. For more information about changing IIS application pool identities, see Changing the Application Pool Identity for a Virtual Server (Windows SharePoint Services 2.0). For more information about user account modes, see Installation Considerations for Windows SharePoint Services 2.0. For more information about full-text search, see Managing and Customizing Search (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
adminportidentity |
Contains the IIS Application Pool identity that is being used for the SharePoint Central Administration port. You can only use the "getproperty" operation with this property —it cannot be set through the command line. To set this property, you must change the IIS Application Pool identity in IIS. |
The IIS Application Pool identity that the Central Administration port is running under |
fulltextsearchenabled |
Specifies whether full text searching and indexing is enabled |
"1" (yes) or "0" (no) |
HTML Viewer Properties
Use these properties to specify HTML Viewer options for your server or server farm. These properties can be set only at the server (and server farm) level. You do not need to specify the -url parameter when you configure these properties. For more information about HTML viewing, see Managing HTML Viewers (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
htmltranslbpath |
Specifies the path (URL) to the HTML Viewer server |
A URL |
htmltransmaxcachesize |
Specifies the maximum cache size for the HTML Viewer |
A numerical value, in MB |
htmltransmaxsize |
Specifies the maximum file size that can be viewed |
A numerical value, in MB |
htmltranson |
Specifies whether HTML viewing is enabled |
"true" or "false" |
htmltranstimeout |
Specifies the timeout time for HTML viewing |
A numerical value, in seconds |
Security Properties
Use these properties to set security policies for Self-Service Site Creation, user names and passwords, and security validation, and to get the virtualserverpermsmask property.
Some of these properties can be set only at the virtual server level. You must specify the -url parameter when you configure these properties. For more information about Self-Service Site Creation, see Configuring Self-Service Site Creation (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
createadaccounts |
Contains a value specifying which user account mode has been configured. "Yes" indicates that you are in Active Directory account creation mode, "no" indicates that you are in domain account mode. You can only use the "getproperty" operation with this property —it cannot be set through the command line. This property is set when you install Windows SharePoint Services and choose a user account mode. This property is only available at the server level and does not take the -url parameter. |
"yes" or "no" |
ssc |
Specifies whether to allow Self-Service Site Creation. This property can only be set at the virtual server level and requires the -url parameter. |
"yes" or "no" |
ssc-contact |
Specifies whether or not to require a secondary contact for sites created by using Self-Service Site Creation. This property can only be set at the virtual server level and requires the -url parameter. |
"yes" or "no" |
adaccountdomain |
Specifies the Active Directory domain name to use for user accounts in Active Directory account creation mode. This property can only be set at the server level and does not take the -url parameter. |
A domain name |
adaccountou |
Specifies the organizational unit to use for user accounts in Active Directory account creation mode. This property can only be set at the server level and does not take the -url parameter. |
An organizational unit name |
send-ad-email |
Specifies whether or not to send usernames and passwords through e-mail. This property can only be set at the virtual server level and requires the -url parameter. |
"true" or "false" |
securityvalidation-enabled |
Specifies whether security credentials must be validated again before an operation that has timed out can be run again. This property can only be set at the virtual server level and requires the -url parameter. |
"true" or "false" |
securityvalidation-expire |
Specifies whether Web Page Security Validation is set to never expire. This property can only be set at the virtual server level and requires the -url parameter. |
"true" or "false" |
securityvalidation-timeout |
Specifies how long (in minutes) to wait before requiring security validation for a timed-out operation. This property can only be set at the virtual server level and requires the -url parameter. |
A number (minutes to wait) |
virtualserverpermsmask |
Contains a value that indicates what changes have been made to the list of user rights available for use on a virtual server with the virtualserverpermsmask property. You can only use the "getproperty" operation with this property — it cannot be set through the command line. This property is set when you make changes to the Manage User Rights for Virtual Server page in SharePoint Central Administration. This property is only available at the virtual server level and requires the -url parameter. For more information about configuring the list of user rights available for use on a virtual server, see Controlling User Rights and Assigning Tasks (Windows SharePoint Services 2.0). |
A hashed number |
Site Confirmation and Automatic Deletion Properties
These properties can be set either at the server (and server farm) level or at the virtual server level. Use the -url parameter to configure these properties for a specific virtual server or omit it to configure these properties for an entire server. For more information about site confirmation and automatic deletion, see Managing Unused Web Sites (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
delete-web-send-email |
Specifies whether to send e-mail notifications about unused Web sites |
"yes" or "no" |
dead-site-notify-after |
Specifies how long to wait before sending the first e-mail notification |
A numerical value (the number of days to wait before sending notifications) |
dead-site-num-notifications |
Specifies how many e-mail notifications to send |
A numerical value (the number of notifications to send) |
dead-site-auto-delete |
Specifies whether to automatically delete unused Web sites |
"yes" or "no" |
job-dead-site-delete |
Specifies when to delete unused Web sites automatically |
A phrase that includes the frequency interval and time range to delete unused Web sites automatically. For example "weekly at Sat 0:00:00". |
Usage Analysis Properties
This property can be set either at the server (and server farm) level or at the virtual server level. Use the -url parameter to configure these properties for a specific virtual server or omit it to configure these properties for an entire server. For more information about usage analysis, see Configuring Usage Analysis (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
job-usage-analysis |
Specifies the frequency (daily, weekly, monthly) and time of day to perform the usage analysis processes. |
A phrase that includes the frequency interval and time range to perform usage analysis log processing. For example "daily between 16:55:00 and 17:00:00". |
If you want the job to start at a specific time, set the beginning and end times to the same time, for example: "daily between 16:55:21 and 16:55:21".
Note
This property can be set only to "daily", not to "weekly" or "immediate".
If you want to view the current setting for the job-usage-analysis property, you must include the -url parameter. For example, to see the current usage analysis setting for the default Web site, use the following syntax:
stsadm.exe -o getproperty -pn job-usage-analysis -url https://localhost
Web Part Configuration Properties
Use these properties to configure Web Part settings. These properties can be set only at the virtual server level. You must specify the -url parameter when you configure these properties. For more information about configuring Web Part settings, see About Web Parts (Windows SharePoint Services 2.0) and Managing Web Parts on Virtual Servers (Windows SharePoint Services 2.0).
Property name | Description | Values |
---|---|---|
spallowglobalcatalog |
Specifies whether users can use the online Web Part gallery |
"1" or "0" |
spallowsp2p |
Specifies whether users can connect Web Parts (pass data or values from a source Web Part to a target Web Part) |
"1" or "0" |