Merging upstream version 9.4.0+dfsg.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 42 insertions, 18 deletions

diff --git a/ansible_collections/dellemc/powerflex/docs/modules/device.rst b/ansible_collections/dellemc/powerflex/docs/modules/device.rst
index 35ae246aa..4fcd82854 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/device.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/device.rst
@@ -20,9 +20,9 @@ Requirements
 ------------
 The below requirements are needed on the host that executes this module.
 
-- A Dell PowerFlex storage system version 3.5 or later.
-- Ansible-core 2.12 or later.
-- PyPowerFlex 1.6.0.
+- A Dell PowerFlex storage system version 3.6 or later.
+- Ansible-core 2.14 or later.
+- PyPowerFlex 1.9.0.
 - Python 3.9, 3.10 or 3.11.
 
 
@@ -134,6 +134,14 @@ Parameters
     State of the device.
 
 
+  force (optional, bool, False)
+    Using the Force flag to add a device.
+
+    Use this flag, to overwrite existing data on the device.
+
+    Use this flag with caution, because all data on the device will be destroyed.
+
+
   hostname (True, str, None)
     IP or FQDN of the PowerFlex host.
 
@@ -201,6 +209,22 @@ Examples
         protection_domain_name: "domain1"
         external_acceleration_type: "ReadAndWrite"
         state: "present"
+    - name: Add a device with force flag
+      dellemc.powerflex.device:
+        hostname: "{{hostname}}"
+        username: "{{username}}"
+        password: "{{password}}"
+        validate_certs: "{{validate_certs}}"
+        port: "{{port}}"
+        current_pathname: "/dev/sdb"
+        sds_name: "node1"
+        media_type: "HDD"
+        device_name: "device2"
+        storage_pool_name: "pool1"
+        protection_domain_name: "domain1"
+        external_acceleration_type: "ReadAndWrite"
+        force: true
+        state: "present"
     - name: Get device details using device_id
       dellemc.powerflex.device:
         hostname: "{{hostname}}"
@@ -232,23 +256,23 @@ Examples
         state: "present"
     - name: Remove a device using device_id
       dellemc.powerflex.device:
-       hostname: "{{hostname}}"
-       username: "{{username}}"
-       password: "{{password}}"
-       validate_certs: "{{validate_certs}}"
-       port: "{{port}}"
-       device_id: "76eb7e2f00010000"
-       state: "absent"
+        hostname: "{{hostname}}"
+        username: "{{username}}"
+        password: "{{password}}"
+        validate_certs: "{{validate_certs}}"
+        port: "{{port}}"
+        device_id: "76eb7e2f00010000"
+        state: "absent"
     - name: Remove a device using (current_pathname, sds_id)
       dellemc.powerflex.device:
-       hostname: "{{hostname}}"
-       username: "{{username}}"
-       password: "{{password}}"
-       validate_certs: "{{validate_certs}}"
-       port: "{{port}}"
-       current_pathname: "/dev/sdb"
-       sds_name: "node1"
-       state: "absent"
+        hostname: "{{hostname}}"
+        username: "{{username}}"
+        password: "{{password}}"
+        validate_certs: "{{validate_certs}}"
+        port: "{{port}}"
+        current_pathname: "/dev/sdb"
+        sds_name: "node1"
+        state: "absent"