# win_partition – Creates, changes and removes partitions on Windows Server

New in version 2.8.

- Synopsis

- Parameters

- Notes

- Examples

- Status

## Synopsis

- The win_partition module can create, modify or delete a partition on a disk

## Parameters

Parameter | Choices/Defaults | Comments
--- | --- | ---

active
boolean

Choices:
- no
- yes

Specifies if the partition is active and can be used to start the system. This property is only valid when the disk's partition style is MBR.

disk_number integer |  | Disk number is mandatory for creating new partitions. A combination of disk_number and partition_number can be used to specify the partition instead of drive_letter if required.
drive_letter string |  | Used for accessing partitions if disk_number and partition_number are not provided. Use `auto` for automatically assigning a drive letter, or a letter A-Z for manually assigning a drive letter to a new partition. If not specified, no drive letter is assigned when creating a new partition.

gpt_type
string

Choices:
- system_partition
- microsoft_reserved
- basic_data
- microsoft_recovery

Specify the partition's GPT type if the disk's partition style is GPT.
This only applies to new partitions.
This does not relate to the partitions file system formatting.

hidden
boolean

Choices:
- no
- yes

Hides the target partition, making it undetectable by the mount manager.

mbr_type
string

Choices:
- fat12
- fat16
- extended
- huge
- ifs
- fat32

Specify the partition's MBR type if the disk's partition style is MBR.
This only applies to new partitions.
This does not relate to the partitions file system formatting.

offline
boolean

Choices:
- no
- yes

Sets the partition offline.
Adding a mount point (such as a drive letter) will cause the partition to go online again.

partition_number integer |  | Used in conjunction with disk_number to uniquely identify a partition.

partition_size
string

Specify size of the partition in B, KB, KiB, MB, MiB, GB, GiB, TB or TiB. Use -1 to specify maximum supported size.
Partition size is mandatory for creating a new partition but not for updating or deleting a partition.
The decimal SI prefixes kilo, mega, giga, tera, etc., are powers of 10^3 = 1000. The binary prefixes kibi, mebi, gibi, tebi, etc. respectively refer to the corresponding power of 2^10 = 1024. Thus, a gigabyte (GB) is 1000000000 (1000^3) bytes while 1 gibibyte (GiB) is 1073741824 (1024^3) bytes.

read_only
boolean

Choices:
- no
- yes

Make the partition read only, restricting changes from being made to the partition.

state
string

Choices:
- absent
- present ←

Used to specify the state of the partition. Use `absent` to specify if a partition should be removed and `present` to specify if the partition should be created or updated.

## Notes

Note

- A minimum Operating System Version of 6.2 is required to use this module. To check if your OS is compatible, see https://docs.microsoft.com/en-us/windows/desktop/sysinfo/operating-system-version.

- This module cannot be used for removing the drive letter associated with a partition, initializing a disk or, file system formatting.

- Idempotence works only if you’re specifying a drive letter or other unique attributes such as a combination of disk number and partition number.

- For more information, see https://msdn.microsoft.com/en-us/library/windows/desktop/hh830524.aspx.

## Examples

    - name: Create a partition with drive letter D and size 5 GiB
      win_partition:
        drive_letter: D
        partition_size: 5 GiB
        disk_number: 1

    - name: Resize previously created partition to it's maximum size and change it's drive letter to E
      win_partition:
        drive_letter: E
        partition_size: -1
        partition_number: 1
        disk_number: 1

    - name: Delete partition
      win_partition:
        disk_number: 1
        partition_number: 1
        state: absent

## Status

- This module is not guaranteed to have a backwards compatible interface. [preview]

- This module is maintained by the Ansible Community. [community]

### Authors

- Varun Chopra (@chopraaa) <v@chopraaa.com>

Hint

If you notice any issues in this documentation, you can edit this document to improve it.