Added module win_pester and relatives integration tests (#37343)

* Added module win_pester and relatives integration tests

* Corrected issues as stated by ansible-test

* Added defaults variable in integration tests

* Added task to install Pester if needed in the integration test

* Corrected error in win_psmodule task

* Added Pester installation with Chocolatey when Powershell version < 5

* Get facts...

* Disabled invoke-pester output

* Added pester_result type

* Added jhawkesworth changes proposal

* Corrected documentation linting

* Corrected linting

* Added dagwieers recommendations

* Added dagwieers recommendations

* Corrected linting errors and task error in integration test

* Corrected error in integration test

* Added dagwieers recommendations

* Corrected requirements in the DOCUMENTATION block

test/integration/targets/win_pester/aliases

@@ -0,0 +1 @@
+windows/ci/group2

test/integration/targets/win_pester/defaults/main.yml

@@ -0,0 +1,12 @@
+---
+local_test_files:
+  - files/test01.test.ps1
+  - files/test02.test.ps1
+remote_test_files:
+  - test01.test.ps1
+  - test02.test.ps1
+fake_remote_test_file: C:\Pester\fake_test.test.ps1
+fake_remote_folder: C:\Fake_Pester
+remote_test_folder: 
+  - C:\Pester\
+  - C:\Pester

test/integration/targets/win_pester/files/test01.test.ps1

@@ -0,0 +1,5 @@
+Describe -Name 'Test01' {
+    It -name 'First Test' {
+        {Get-Service} | Should Not Throw
+    }
+}

test/integration/targets/win_pester/files/test02.test.ps1

@@ -0,0 +1,5 @@
+Describe -Name 'Test02' {
+    It -name 'Second Test' {
+        {Get-Service} | Should Throw
+    }
+}

test/integration/targets/win_pester/tasks/main.yml

@@ -0,0 +1,117 @@
+---
+- name: Get facts
+  setup:
+
+- name: Add Pester module
+  win_psmodule:
+    name: Pester
+    state: present
+  when: ansible_powershell_version >= 5
+
+- name: Add Pester module with Chocolatey
+  win_chocolatey:
+    name: Pester
+    state: present
+  when: ansible_powershell_version < 5
+
+- name: Copy test file(s)
+  win_copy:
+    src: "{{ item }}"
+    dest: "{{ remote_test_folder[0] }}"
+  with_items: "{{local_test_files}}"
+
+- name: Run Pester test(s) specifying a fake test file
+  win_pester:
+    path: "{{ fake_remote_test_file }}"
+  register: result
+  ignore_errors: yes
+
+- name: Assert result
+  assert:
+    that: 
+      - result.failed == true
+
+- name: Run Pester test(s) specifying a fake folder
+  win_pester:
+    path: "{{ fake_remote_folder }}"
+  register: result
+  ignore_errors: yes
+
+- name: Assert result
+  assert:
+    that: 
+      - result.failed == true
+
+- name: Run Pester test(s) specifying a test file and a higher pester version
+  win_pester:
+    path: "{{ remote_test_folder[0] }}{{ remote_test_files[0] }}"
+    minimum_version: 6.0.0
+  register: result
+  ignore_errors: yes
+
+- name: Assert result
+  assert:
+    that: 
+      - result.failed == true
+
+- name: Run Pester test(s) specifying a test file
+  win_pester:
+    path: "{{ remote_test_folder[0] }}{{ remote_test_files[0] }}"
+  register: result
+
+- name: Assert result
+  assert:
+    that: 
+      - result.failed == false
+      - result.output.TotalCount == 1
+
+- name: Run Pester test(s) specifying a test file and with a minimum mandatory Pester version
+  win_pester:
+    path: "{{ remote_test_folder[0] }}{{ remote_test_files[0] }}"
+    minimum_version: 3.0.0
+  register: result
+
+- name: Assert result
+  assert:
+    that: 
+      - result.failed == false
+      - result.output.TotalCount == 1
+
+- name: Run Pester test(s) located in a folder. Folder path end with '\'
+  win_pester:
+    path: "{{ remote_test_folder[0] }}"
+  register: result
+
+- name: Assert result 
+  assert:
+    that: 
+      - result.failed == false
+      - result.output.TotalCount == 2
+
+- name: Run Pester test(s) located in a folder. Folder path does not end with '\' 
+  win_pester:
+    path: "{{ remote_test_folder[1] }}"
+  register: result
+
+- name: Assert result 
+  assert:
+    that: 
+      - result.failed == false
+      - result.output.TotalCount == 2
+
+- name: Run Pester test(s) located in a folder and with a minimum mandatory Pester version
+  win_pester:
+    path: "{{ remote_test_folder[0] }}"
+    minimum_version: 3.0.0
+  register: result
+
+- name: Assert result 
+  assert:
+    that: 
+      - result.failed == false
+      - result.output.TotalCount == 2
+
+- name: Delete test folder
+  win_file:
+    path: "{{ remote_test_folder[0] }}"
+    state: absent