community.windows.win_partition 模块 – 在 Windows Server 上创建、更改和删除分区

注意

此模块是 community.windows 集合（版本 2.3.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.windows。

要在 Playbook 中使用它，请指定：community.windows.win_partition。

概要

参数

参数

注释

active

布尔值

指定分区是否处于活动状态，并且可用于启动系统。此属性仅在磁盘的分区样式为 MBR 时有效。

选项

  • false

  • true

disk_number

整数

创建新分区时，磁盘编号是强制性的。

如果需要，可以使用 disk_number 和 partition_number 的组合来指定分区，而不是 drive_letter。

drive_letter

字符串

如果未提供 disk_number 和 partition_number，则用于访问分区。

使用 auto 自动分配驱动器号，或者使用字母 A-Z 为新分区手动分配驱动器号。如果未指定，则在创建新分区时不会分配驱动器号。

gpt_type

字符串

如果磁盘的分区样式为 GPT，则指定分区的 GPT 类型。

这仅适用于新分区。

这与分区的 文件系统格式化无关。

选项

  • "system_partition"

  • "microsoft_reserved"

  • "basic_data"

  • "microsoft_recovery"

hidden

布尔值

隐藏目标分区，使其无法被挂载管理器检测到。

选项

  • false

  • true

mbr_type

字符串

如果磁盘的分区样式为 MBR，则指定分区的 MBR 类型。

这仅适用于新分区。

这与分区的 文件系统格式化无关。

选项

  • "fat12"

  • "fat16"

  • "extended"

  • "huge"

  • "ifs"

  • "fat32"

offline

布尔值

使分区脱机。

添加挂载点（例如驱动器号）将导致分区再次联机。

选项

  • false

  • true

partition_number

整数

与 disk_number 结合使用以唯一标识分区。

partition_size

字符串

以 B、KB、KiB、MB、MiB、GB、GiB、TB 或 TiB 为单位指定分区大小。使用 -1 指定支持的最大大小。

分区大小对于创建新分区是强制性的，但对于更新或删除分区则不是。

十进制 SI 前缀 kilo、mega、giga、tera 等是 10^3 = 1000 的幂。二进制前缀 kibi、mebi、gibi、tebi 等分别指代 2^10 = 1024 的相应幂。因此，千兆字节 (GB) 是 1000000000 (1000^3) 字节，而 1 吉比字节 (GiB) 是 1073741824 (1024^3) 字节。

read_only

布尔值

使分区只读，限制对分区进行更改。

选项

  • false

  • true

state

字符串

用于指定分区状态。使用 absent 指定是否应删除分区，使用 present 指定是否应创建或更新分区。

选项

  • "absent"

  • "present" ← (默认)

说明

注意

示例

- name: Create a partition with drive letter D and size 5 GiB
  community.windows.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
  community.windows.win_partition:
    drive_letter: E
    partition_size: -1
    partition_number: 1
    disk_number: 1

- name: Delete partition
  community.windows.win_partition:
    disk_number: 1
    partition_number: 1
    state: absent

作者

  • Varun Chopra (@chopraaa)