Files
winsw/doc/extensions/sharedDirectoryMapper.md
Oleg Nenashev 0f354b42ac Document the extension engine and exisitng extensions (#141)
* Document the extension engine and exisitng extensions

* Add the link to Extensions in ToC
2016-12-02 13:59:26 +01:00

39 lines
1.1 KiB
Markdown

Shared Directory Mapper extension
====
By default Windows does not establish shared drive mapping for services even if it is configured in the Windows service profile.
And sometimes it is impossible to workaround it due to the domain policies.
This extension allows mapping external shared directories before starting up the executable.
Since: [WinSW 2.0](../../CHANGELOG.md).
### Usage
The extension can be configured via the [XML Configuration File](../xmlConfigFile.md).
Configuration sample:
```xml
<?xml version="1.0" encoding="utf-8" ?>
<service>
<id>sampleService</id>
<name>Sample service</name>
<description>This is a stub service.</description>
<executable>%BASE%\sleep.bat</executable>
<arguments></arguments>
<logmode>rotate</logmode>
<extensions>
<extension enabled="true" className="winsw.Plugins.SharedDirectoryMapper.SharedDirectoryMapper" id="mapNetworDirs">
<mapping>
<map enabled="false" label="N:" uncpath="\\UNC"/>
<map enabled="false" label="M:" uncpath="\\UNC2"/>
</mapping>
</extension>
</extensions>
</service>
```
### Notes
* If the extension fails to map the drive, the startup fails