Модуль community.windows.win_partition — создание, изменение и удаление разделов в Windows Server

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_partition.

Обзор
Параметры
Примечания
Примеры

Обзор

Модуль community.windows.win_partition позволяет создавать, изменять и удалять разделы на диске

Параметры

Параметр	Комментарии
active boolean	Указывает, является ли раздел активным и может ли он использоваться для запуска системы. Это свойство действительно только в том случае, если стиль разметки диска — MBR. Варианты: `false` `true`
disk_number integer	Для создания новых разделов необходимо указать номер диска. При необходимости для указания раздела вместо drive_letter можно использовать сочетание disk_number и partition_number.
drive_letter string	Используется для доступа к разделам, если параметры disk_number и partition_number не указаны. Укажите `auto`, чтобы назначить букву диска автоматически, или букву от A до Z, чтобы вручную назначить букву диска новому разделу. Если параметр не указан, при создании нового раздела буква диска не назначается.
gpt_type string	Укажите тип GPT раздела, если стиль разметки диска — GPT. Применяется только к новым разделам. Этот параметр не связан с форматированием файловой системы раздела. Варианты: `"system_partition"` `"microsoft_reserved"` `"basic_data"` `"microsoft_recovery"`
hidden boolean	Скрывает целевой раздел, делая его невидимым для диспетчера точек подключения. Варианты: `false` `true`
mbr_type string	Укажите тип MBR раздела, если стиль разметки диска — MBR. Применяется только к новым разделам. Этот параметр не связан с форматированием файловой системы раздела. Варианты: `"fat12"` `"fat16"` `"extended"` `"huge"` `"ifs"` `"fat32"`
offline boolean	Переводит раздел в автономный режим. Добавление точки подключения (например, буквы диска) снова переведёт раздел в оперативный режим. Варианты: `false` `true`
partition_number integer	Используется совместно с disk_number для однозначной идентификации раздела.
partition_size string	Укажите размер раздела в B, KB, KiB, MB, MiB, GB, GiB, TB или TiB. Укажите -1, чтобы задать максимально допустимый размер. При создании нового раздела необходимо указать его размер, но при обновлении или удалении раздела это не требуется. Десятичные приставки СИ кило-, мега-, гига-, тера- и т. д. соответствуют степеням 10^3 = 1000. Двоичные приставки киби-, меби-, gibi-, теби- и т. д. соответствуют степеням 2^10 = 1024. Таким образом, гигабайт (GB) равен 1000000000 (1000^3) байт, а гибибайт (GiB) — 1073741824 (1024^3) байт.
read_only boolean	Переводит раздел в режим «только чтение», запрещая вносить в него изменения. Варианты: `false` `true`
state string	Используется для указания состояния раздела. Укажите `absent`, чтобы задать удаление раздела, и `present`, чтобы задать создание или обновление раздела. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

Для использования этого модуля требуется операционная система версии не ниже 6.2. Сведения о совместимости вашей ОС см. на странице https://docs.microsoft.com/en-us/windows/desktop/sysinfo/operating-system-version.
Этот модуль нельзя использовать для удаления буквы диска, связанной с разделом, инициализации диска или форматирования файловой системы.
Идемпотентность обеспечивается только при указании буквы диска или других уникальных атрибутов, например сочетания номера диска и номера раздела.
Дополнительную информацию см. на странице https://msdn.microsoft.com/en-us/library/windows/desktop/hh830524.aspx.

Примеры

- 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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_partition_module.html