Export (0) Print
Expand All

SPIisSettings class

Represents the Internet Information Services (IIS) authentication settings that are shared across all of the web servers for a specific URL zone, which can be modified and propagated by re-provisioning the web application.

Namespace:  Microsoft.SharePoint.Administration
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public sealed class SPIisSettings : SPAutoSerializingObject

Use the CreateFromExistingWebSite method to create an SPIisSettings object for a specified IIS website, or use the IisSettings property of the SPWebApplication class to return the IIS settings for a particular URL zone. To return the settings for a specific zone, you can specify an SPUrlZone value as an indexer on the IisSettings property.

Setting a property value of the SPIisSettings class, such as AllowAnonymous, does not automatically propagate the new value to all IIS websites across all front-end Web servers. The properties are applied to IIS websites only after the web application is re-provisioned.

The following example displays, in a console application, the virtual directory path for the Default URL zone of a specified web application.

System.Uri uri = new Uri("http://MyServer");
SPWebApplication webApplication = SPWebApplication.Lookup(uri);
SPIisSettings iis = webApplication.IisSettings[SPUrlZone.Default];
Console.Write(iis.Path + " == " + iis.PreferredInstanceId.ToString());

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft