NAntContrib Help Task Reference <mkiisdir> | v0.85-rc1 |
[This is preliminary documentation and subject to change.]
Creates or modifies a virtual directory of a web site hosted on Internet Information Server.
If the virtual directory does not exist it is created, and if it already exists it is modified. Only the IIS-properties specified will be set. If set by other means (e.g. the Management Console), the unspecified properties retain their current value, otherwise they are inherited from the parent.
For a list of optional parameters see IIsWebVirtualDir.
Attribute | Type | Description | Required |
---|---|---|---|
dirpath | directory | The file system path. | True |
accessexecute | bool | False | |
accessnoremoteexecute | bool | False | |
accessnoremoteread | bool | False | |
accessnoremotescript | bool | False | |
accessnoremotewrite | bool | False | |
accessread | bool | False | |
accessscript | bool | False | |
accesssource | bool | False | |
accessssl | bool | False | |
accessssl128 | bool | False | |
accesssslmapcert | bool | False | |
accesssslnegotiatecert | bool | False | |
accesssslrequirecert | bool | False | |
accesswrite | bool | False | |
anonymouspasswordsync | bool | False | |
appallowclientdebug | bool | False | |
appallowdebugging | bool | False | |
appcreate | AppType | Specifies what type of application to create for this virtual directory. The default is Pooled . |
False |
aspallowsessionstate | bool | False | |
aspbufferingon | bool | False | |
aspenableapplicationrestart | bool | False | |
aspenableasphtmlfallback | bool | False | |
aspenablechunkedencoding | bool | False | |
aspenableparentpaths | bool | False | |
aspenabletypelibcache | bool | False | |
asperrorstontlog | bool | False | |
aspexceptioncatchenable | bool | False | |
asplogerrorrequests | bool | False | |
aspscripterrormessage | string | False | |
aspscripterrorsenttobrowser | bool | False | |
aspthreadgateenabled | bool | False | |
asptrackthreadingmodel | bool | False | |
authanonymous | bool | False | |
authbasic | bool | False | |
authntlm | bool | False | |
authpersistsinglerequest | bool | False | |
authpersistsinglerequestalwaysifproxy | bool | False | |
authpersistsinglerequestifproxy | bool | False | |
cachecontrolnocache | bool | False | |
cacheisapi | bool | False | |
contentindexed | bool | False | |
cpuappenabled | bool | False | |
cpucgienabled | bool | False | |
createcgiwithnewconsole | bool | False | |
createprocessasuser | bool | False | |
defaultdoc | string | False | |
dirbrowseshowdate | bool | False | |
dirbrowseshowextension | bool | False | |
dirbrowseshowlongdate | bool | False | |
dirbrowseshowsize | bool | False | |
dirbrowseshowtime | bool | False | |
dontlog | bool | False | |
enabledefaultdoc | bool | False | |
enabledirbrowsing | bool | False | |
enabledocfooter | bool | False | |
enablereversedns | bool | False | |
ssiexecdisable | bool | False | |
uncauthenticationpassthrough | bool | False | |
vdirname | string | Name of the IIS virtual directory. | True |
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False |
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False |
iisserver | string | The IIS server, which can be specified using the format [host]:[port] . The default is localhost:80 . |
False |
unless | bool | Opposite of if . If false then the task will be executed; otherwise, skipped. The default is false. |
False |
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False |
Create a virtual directory named Temp
pointing to c:\temp
on the local machine.
<mkiisdir dirpath="c:\temp" vdirname="Temp" />
Create a virtual directory named Temp
pointing to c:\temp
on machine Staging
.
<mkiisdir iisserver="Staging" dirpath="c:\temp" vdirname="Temp" />
Configure the home directory of for http://svc.here.dev/ to point to D:\Develop\Here and require authentication
<mkiisdir iisserver="svc.here.dev" dirpath="D:\Develop\Here" vdirname="/" authanonymous="false"/>
Create a virtual directory named WebServices/Dev
pointing to c:\MyProject\dev
on the web site running on port 81
of machine MyHost
.
<mkiisdir iisserver="MyHost:81" dirpath="c:\MyProject\dev" vdirname="WebServices/Dev" />Note that if
WebServices
is neither an existing virtual directory nor an existing physical subdirectory of the web root, your IIS Management Console will get confused. Even though http://MyHost:81/WebServices/Dev/theService.asmx
may be a perfectly working webservice, the Management Console will not show it.