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)