community.windows.win_initialize_disk – Initializes disks on Windows Server¶
Note
This plugin is part of the community.windows collection (version 1.3.0).
To install it use: ansible-galaxy collection install community.windows
.
To use it in a playbook, specify: community.windows.win_initialize_disk
.
Synopsis¶
The community.windows.win_initialize_disk module initializes disks
Parameters¶
Notes¶
Note
One of three parameters (disk_number, uniqueid, and path) are mandatory to identify the target disk, but more than one cannot be specified at the same time.
A minimum Operating System Version of Server 2012 or Windows 8 is required to use this module.
This module is idempotent if force is not specified.
See Also¶
See also
- community.windows.win_disk_facts
The official documentation on the community.windows.win_disk_facts module.
- community.windows.win_partition
The official documentation on the community.windows.win_partition module.
- community.windows.win_format
The official documentation on the community.windows.win_format module.
Examples¶
- name: Initialize a disk
community.windows.win_initialize_disk:
disk_number: 1
- name: Initialize a disk with an MBR partition style
community.windows.win_initialize_disk:
disk_number: 1
style: mbr
- name: Forcefully initiallize a disk
community.windows.win_initialize_disk:
disk_number: 2
force: yes
Authors¶
Brant Evans (@branic)