diff --git a/lib/ansible/modules/extras/windows/win_iis_virtualdirectory.py b/lib/ansible/modules/extras/windows/win_iis_virtualdirectory.py
index e5bbd950007..4754c3802d9 100644
--- a/lib/ansible/modules/extras/windows/win_iis_virtualdirectory.py
+++ b/lib/ansible/modules/extras/windows/win_iis_virtualdirectory.py
@@ -22,9 +22,9 @@ DOCUMENTATION = '''
 ---
 module: win_iis_virtualdirectory
 version_added: "2.0"
-short_description: Configures a IIS virtual directories.
+short_description: Configures a virtual directory in IIS.
 description:
-     - Creates, Removes and configures a IIS Web site
+     - Creates, Removes and configures a virtual directory in IIS.
 options:
   name:
     description:
@@ -39,14 +39,11 @@ options:
       - absent
       - present
     required: false
-    default: null
-    aliases: []
+    default: present
   site:
     description:
       - The site name under which the virtual directory is created or exists.
-    required: false
-    default: null
-    aliases: []
+    required: true
   application:
     description:
       - The application under which the virtual directory is created or exists.
@@ -63,5 +60,12 @@ author: Henrik Wallström
 '''
 
 EXAMPLES = '''
+# This creates a virtual directory if it doesn't exist.
+$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite state=present physical_path=c:\\virtualdirectory\\some" host
 
+# This removes a virtual directory if it exists.
+$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite state=absent" host
+
+# This creates a virtual directory on an application if it doesn't exist.
+$ ansible -i hosts -m win_iis_virtualdirectory -a "name='somedirectory' site=somesite application=someapp state=present physical_path=c:\\virtualdirectory\\some" host
 '''