win_iis_webapplication: Parameter fixes and check-mode (#26082)

This PR includes:
- General cleanup of parameters
- Added check-mode support
- Cleanup of return values

lib/ansible/modules/windows/win_iis_webapplication.py

@@ -22,49 +22,36 @@ ANSIBLE_METADATA = {'metadata_version': '1.0',
                     'status': ['preview'],
                     'supported_by': 'community'}
 
-
 DOCUMENTATION = r'''
 ---
 module: win_iis_webapplication
 version_added: "2.0"
-short_description: Configures IIS web applications.
+short_description: Configures IIS web applications
 description:
-     - Creates, removes, and configures IIS web applications.
+- Creates, removes, and configures IIS web applications.
 options:
   name:
     description:
-      - Name of the web application.
+    - Name of the web application.
     required: true
-    default: null
-    aliases: []
   site:
     description:
-      - Name of the site on which the application is created.
+    - Name of the site on which the application is created.
     required: true
-    default: null
-    aliases: []
   state:
     description:
-      - State of the web application.
-    choices:
-      - present
-      - absent
-    required: false
-    default: null
-    aliases: []
+    - State of the web application.
+    choices: [ absent, present ]
+    default: present
   physical_path:
     description:
-      - The physical path on the remote host to use for the new application. The specified folder must already exist.
-    required: false
-    default: null
-    aliases: []
+    - The physical path on the remote host to use for the new application.
+    - The specified folder must already exist.
   application_pool:
     description:
-      - The application pool in which the new site executes.
-    required: false
-    default: null
-    aliases: []
-author: Henrik Wallström
+    - The application pool in which the new site executes.
+author:
+- Henrik Wallström
 '''
 
 EXAMPLES = r'''
@@ -75,3 +62,16 @@ EXAMPLES = r'''
     state: present
     physical_path: C:\apps\acme\api
 '''
+
+RETURN = r'''
+application_pool:
+    description: The used/implemented application_pool value
+    returned: success
+    type: string
+    sample: DefaultAppPool
+physical_path:
+    description: The used/implemented physical_path value
+    returned: success
+    type: string
+    sample: C:\apps\acme\api
+'''